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Traitement de documents XML 

XSLT est un langage ne de la necessite de trailer des documents XML. 

Traiter des documents XML est de fait une necessite, etant donne son utilisation massive 
dans un grand nombre de secteurs de I'informatique, mais traiter un document XML par 
XSLT n'en n'est pas une : ce n'est qu'une possibilite parmi d'autres. Actuellement, il y a 
trois voies differentes pour le traitement d'un document XML : 

• On peut utiliser une feuille de style CSS, si le but est uniquement un habillage HTML 
du document XML : les possibilites se reduisent en gros a des choix de rendu d' aspect 
du document, comme la taille d'une fonte, I'epaisseur d'un cadre, etc. II est impossible 
de modifier la structure du document, mais dans des cas tres simples, et a condition 
que le traitement puisse etre confie a un navigateur, cela peut suffire. 

• On peut developper un programme de traitement, par exemple en Java, ou en d'autres 
langages permettant d'acceder facilement a la representation arborescente d'un docu- 
ment XML (avec Java, par exemple, on dispose d' API comme DOM, JDOM ou SAX 
pour ce faire). Dans ce cas, il n'y a aucune limitation, on fait ce qu'on veut, et ou on 
veut (aussi bien sur un serveur que sur un poste client). 

• Enfin, on peut utiliser XSL (extensible Stylesheet Language), qui regroupe des lan- 
gages specifiques pour la description de transformations et de rendu de document 
XML, dont XSLT fait partie. II n'y a en principe pas de limitation theorique a la nature 
des traitements realisables par XSL, du moment qu'on s'en tient a vouloir traiter des 
documents XML ; XSL est utilisable aussi bien sur le poste client que sur un serveur. 

Comme XSL est specialement adapte au traitement de documents XML, on peut penser 
qu' il est plus simple de realiser le traitement desire en XSL, plutot que d' utiliser un langage 
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generaliste comme Java ou C++. C'est vrai, mais cette affinnation doit etre largement 
nuancee dans la pratique. En effet, un des problemes de XSL en general et de XSLT en 
particulier, est que ce sont des langages assez destabilisants, dans la mesure oil ils 
demandent aux programmeurs des competences dans des domaines qui sont generale- 
ment assez peu frequentes. Un expert XSLT mettra tres certainement beaucoup moins de 
temps a realiser le traitement demande que 1' expert Java utilisant les API SAX (Simple 
API for XML) ou DOM (Document Object Model) pour faire le meme travail ; le seul 
probleme, a vrai dire, est d'etre expert XSLT. 

A titre de comparaison, lorsque le langage Java a ete rendu public et disponible, un expert 
C++ ou Smalltalk (ou langage a objets, d'une fagon plus generale) a qui Ton presentait ce 
langage, en faisait le tour en une semaine, le temps de s'habituer aux caracteristiques spe- 
cifiques ; mais son mode de pensee restait fondamentalement intact. 

A I'inverse, prenez un expert SQL, ou Java, ou C, ou Visual Basic, et presentez-lui 
XSLT : il n'aura pratiquement rien a quoi se raccrocher ; tout pour lui sera nouveau ou 
presque, sauf s'il a une bonne culture dans le domaine des langages fonctionnels ou 
declaratifs (Prolog, Lisp, Caml, etc.). 

Pourtant, il ne faut pas croire que XSLT soit un langage specialement difficile ou com- 
plexe ; il est meme beaucoup moins complexe que C++. Mais il est deroutant, parce qu'il 
nous fait penetrer dans un monde auquel nous ne sommes en general pas habitues. 

En resume, si vous avez a faire un traitement non trivial sur un document XML, et que 
vous etes novice en XSLT, prevoyez une phase importante d'investissement personnel 
initial dans le calcul de votre delai, ou realisez votre traitement en programmation tradi- 
tionnelle, avec des API comme SAX ou DOM. Mais ce n'est pas une solution rentable a 
moyen terme, car il est certain qu'une fois la competence acquise, on est beaucoup plus 
efficace en XSLT qu'on peut I'etre en Java ou C++ pour realiser une transformation 
donnee. 

Le langage XSL 

Statut actuel 

Le W3C n'est pas un organisme de normalisation officiel ; il ne peut done pretendre edi- 
ter des normes ou des standards. C'est pourquoi un document final du W3C est appele 
Recommendation, terme qui peut sembler un peu bizarre au premier abord. Mais une 
Recommendation du W3C n'a rien a voir avec un recueil de conseils, et c'est un docu- 
ment qui equivaut de fait a un standard, redige dans le style classique des specifications. 
Dans toute la suite, nous parlerons neanmoins de standards XSL ou XSLT, meme si ce ne 
sont pas des standards au sens officiel du terme. 

Le langage XSL (extensible Stylesheet Language) est un langage dont la specification 
est divisee en deux parties : 

• XSLT (XSL Transformation) est un langage de type XML qui serf a decrire les trans- 
formations d'un arbre XML en un autre arbre XML. Le standard XSLT 1.0 est une 
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W3C Recommendation du 16 novembre 1999 (voir VA/vw.w3.org/TR/xslt}. A noter que les 
attributs de certains elements XML de ce langage contiennent des chaines de carac- 
teres dont la syntaxe et la semantique obeissent a un autre langage, nomme XPath (XML 
Path Language), qui n'a rien a voir avec XML, et dont le but est de decrire des ensem- 
bles de noeuds de I'arbre XML du document source a traiter. Le langage XPath 1.0 a 
fait I'objet d'une W3C Recommendation du 16 novembre 1999 (voir http://www.w3c.org/ 
TR/xpath). 

• XSLFO (XSL Formating Objects) est un langage de type XML utilise pour la descrip- 
tion de pages imprimables en haute qualite typographique. Le standard XSLFO 1 .0 est 
une W3C Recommendation du 15 octobre 2001 (voir http://www.w3c.org/TR/XSL). 

Ces deux parties s'integrent dans une chaine de production resumee a la figure 1-1. 




XSLT peut etre utilise seul, et d'ailleurs, pendant les deux ans qui ont separes la publica- 
tion des standards respectifs de XSLT et XSLFO, on ne pouvait guere faire autrement 
que d'utiliser XSLT seul. 

Inversement, il ne semble pas tres pertinent et encore moins facile d'utiliser XSLFO 
seul : la description de pages imprimables reclame des competences qui relevent plus de 
celles d'un typographe. A defaut de les posseder, il semble plus prudent de laisser la 
generation de documents XSLFO a un processeur XSLT equipe de regies de traduction 
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adequates et toutes faites, ou tout au moins d'une bibliotheque de regies de plus haut 
niveau quecellesqu'on pourraitecrire en partantdezero sur la comprehension desobjets 
manipules par XSLFO. Une autre possibilite pourrait etre d'employer un logiciel de 
transformation, qui generedu FO a parti rde documents RTF ou Latex, par exemple, mais 
on entre ici dans un domainequi n'a plus rien avoir avec I'objet dece livre. 

Commeon peutle voir sur la figure 1-1, il est possible, sous certaines conditions, d'obte- 
nirdu texte, du HTM L ou du XM L en sortiedeXSLT. En effet, bien queXSLT soittou- 
jours presente comme un langage de transformation d'arbres XML (I'arbre XML du 
document source est transforms en un autre arbre XML resultat), un processeur X SLT est 
equipe d'un serialisateur qui permet d'obtenir une representation de I'arbre resultat sous 
la forme d'une suite de caracteres. Le processus de serialisation est parametrable pour 
obtenir facilement du texte brut, du HTM L ou du XM L. Commeon peut obtenir du texte 
brut non balise au format XML, on peut done envisager de programmer des transfor- 
mations qui aboutissent a des documents RTF ou Latex, voire directement au format 
Postscript ou PDF. Mais comme les processeurs XSLFO commencent a offrir un fonc- 
tionnement stable et utilisable, ce genre de prouesse sera probablement de moins en 
moins envisagee a I'avenir. 

Une des transformations les plus courantes reste bien sur la transformation XML vers 
XHTML ou HTML, maisil ne faut pas imaginer que le langage X SLT a ete fait pour 5a, 
memesi I 'allusion aux feuillesdest/le (stylesheet) dans le nom memed'XSL encourage 
a cette assimilation beaucoup trop reductrice : la production d'HTM L n'est qu'une pos- 
sibilite parmi d'autres, 

Evolutions 

XSL est un langage qui evolue sous la pression des utilisateurs, des implementeurs de 
processeurs X SLT ou XSL-FO, et des grands editeurs de logiciels. Le role du W3C est 
entre autres de canal iser ces evolutions, afin de prendre en compte les demandes les 
plus i nteressantes, et de les el ever au rang de standard (ou W3C Recommendation). Le 
20decembre 2001, le W3C a publie des Working Drafts annon§ant des evolutions 
majeures de X SLT et de X Path : W3C Working Draft XSLT2.0 et W3C Working Draft 
XPath 2.0. Ces documents deboucheront a terme sur un standard X SLT 2.0 et un stan- 
dard X Path 2.0. Pour I 'instant beaucoup dechoses restenten discussion, etd'ailleurs I'un 
des buts de ces publications est precisement de declencher les debats et les reactions, 
dont les retombees peuventeventuellementetre extremement importantes dans les choix 
final ement retenus. 

Avant \eW3C Working Draft XSLT 2.0, 11 y a eu un W3C Working Draft XSLT 1.1, qui est 
reste et restera a jamais a I'etat de Working Draft, car le groupe de travail charge de la 
redaction de la Final Recommendation s'est rendu compte que les evolutions proposees 
etaientvraiment majeures, ets'accordaientdonc mal avec un simple passage de 1.0 a 1.1. 
Les travaux de la lignee l.xx ont done ete abandonnes, et reintegres a ceux de la lignee 
2, XX, 
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Divers modes d'utilisation de XSLT 

XSLT estun langage interprete ; acetitreil reclame un interpreteur (souventappele pro- 
cesseur XSLT) qui peutetre lance de diverses fagons, suivant I'objectif a atteindre. 

Mode Commande 

Le mode Commande est le mode qui consiste a lancer (a la main ou en tant que com- 
mande faisant partie d'un fichier de commandes) le processeur XSLT en lui passant les 
arguments qu'il attend (le fichier contenant la feuillede style XSLT aexecuter, le fichier 
XM L a traiter, et le nom du fichier resultat, plus divers parametres ou options). 

Ce mode convient pour les traitements non interactifs, etc'estd'ailleurs celui qui off re le 
plus de souplesse en ce sens qu'il ne requiert aucune liaison particuliere entre le fichier 
XML et la feuille de style de traitement : la meme feuille de style peut traiter plusieurs 
fichiersXM L differents, etun memefichierX M L peutetretraite par plusieursfeuilles de 
style XSLT differentes. 

C'est aussi un mode qui n'impose aucun format de sortie particulier : on peut generer 
aussi bien du HTM L que du XM L, du Latex, etc. 

Processeurs courants 

En mode Commande, les processeurs les plus courants sontXt, Xalan, et Saxon, 

Xt est le premier processeur XSLT a etre apparu ; il a ete ecrit par un grand maltre de 
SGML et de DSSSL (I'equivalent de XSLT pour SGM L), James Clark, qui est aussi 
I'editeur de la norme XSLT 1.0 du W3C. Xt n'est pas tout a fait complet, et ne le sera 
jamais, car il n'y a plus aucun developpement sur ce produit. Cependant, Xt reste 
aujourd'hui le pi us rapide de tous les processeurs X SLT. C 'est un produit « open source » 
gratuit (ecrit en J ava), que I 'on peut obteni r sur www.jciark.com/xmi/xt.htmi. 

Saxon est le processeur XSLT ecrit par Michael Kay, egalement auteur du premier 
manuel de reference sur le langage XSLT. C'est un produit libre et gratuit, dont les 
sources SOnt disponibles (en J ava) sur http://saxon.sourceforge.net/ 

Pour I'avoir utilise, mon avis est qu'il est tres rapide, bien documents et tres stable. De 
plus, il est complet, et meme plus que complet, puisqu'il implemente les nouvelles fonc- 
tionnalites annoncees dans leW3C Working Draft XSLT 1.1, et meme, a titre experimen- 
tal, celles annoncees dans leW3C Working DraftXSLT 2.0. 

Une version empaquetee sous forme d'un executable Windows existe aussi (Instant 
Saxon), mais n'est pas aussi rapide a I'execution que la version ordinaire. Elle est a 
conseiller uniquementaceux qui veulent tester Saxon sur une plate-forme Windows sans 
avoir a installer une machine virtuelle J ava. 

Xalan est un processeur « open source » produit par Apache. C'est un produit libre et 
gratuit, dont les sources sont disponibles, quel'on peut I 'obteni r sur w/py/xm/.apacrte.org/ 
xalan-J/ 
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Comme Saxon, c'est un produit tres largement utilise par la communaute d'utilisateurs, 
done tres fiable. 1 1 est complet par rapport au standard X SLT 1.0. 

Signalons pour finir que MSXSL, le processeur XSLT de Microsoft (fourni avec 
MSXML3 ou 4), est fait pour etre lance en mode Commande, bien que les transfor- 
mations XSLT au travers du navigateur Internet Explorer soient plus popul aires. Sur les 
plates-formes Windows, 11 est plus rapide que Saxon. 

II y a evidemment beaucoup d'autres processeurs XSLT : on pourra, si I'on veut, faire 
son marche sur certains sites qui les recensent, comme par exemple : www.w3c.org/styie/ 
XSL, www.xmlsoftware.com/xslt, et www.xml.com/. 

Mode Navigateur 

Le mode navigateur est un mode qui ne fonctionne qu'avec un navigateur equipe d'un 
processeur XSLT (par exemple Internet Explorer 5 avec MSXML3 (ou 4), IE6 ou 
N etscape 6). A priori, ce mode de fonctionnement est typiquement fait pour que la trans- 
formation XSL aboutisse a du HTML : le serveur HTTP, en reponse a une requete, 
envoie un document XM L et la feuille de style qui genere le code HTM L adequat. Le 
gain attendu est double (voire triple) : 

• LesdocumentsXM L qui transitentsur le reseau sont generalement moins bavardsque 
leur equivalent HTM L : on gagne de la bande passante. 

• II arrive assez souvent que cesoit la meme feuille de style qui puisse traiter plusieurs 
documents XML differents (en provenance du meme serveur) ; dans ce cas les tech- 
niques de memoire cache sur le navigateur economisent a nouveau de la bande pas- 
sante. 

• A plus long terme, si le contenu du Web s'enrichit progressivement de documents 
de plus en plus souvent XML et de moins en moins souvent HTM L, les moteurs de 
recherche auront moins de mal a selectionner de information plus pertinente, parce 
que X M L est beaucoup plus tourne vers I'expression de la semantique du contenu que 
nel'estHTML. 

N 'oublions pas non plus que la transformation X SLT sur le poste client decrott de fagon 
notable la charge du serveur en termes de CPU et de memoire consommee : moins de 
bande passante reseau utilisee et moins de ressources consommees sur I e serveur sont les 
gains theoriques que I'on peut attendre de ce mode de fonctionnement. M ais bien sflr, 11 
faudra du temps pour que tout cela devienne courant : pour I'instant I'evolution vers le 
traitement local de pages X M L ne fait que commencer. 

Processeurs courants 

En mode Navigateur, 11 n'y a guere que IE5 ou IE6 de M icrosoft qui soient vraiment 
aboutis pour les transformations XSLT (bien que Netscape 6 soit depuis peu un concur- 
rent dans ce domaine). A noter que IE5 necessite une installation auxiliaire, celle de 
MSXML3 (ou 4), qui offre une bonne implementation de XSLT 1.0. On peut obtenir 
M SX M LB ou M SX M L4 sur http://msdn.microsoft.com/xml. 
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Netscape 6 est une alternative interessante pour XSLT. II peut y avoir encore quelques 
problemes d'application de feuilles CSS au resultat obtenu, mais les evolutions sont 
rapides en ce moment: il faut consulter le site www.moziiia.org/projects/xsit pour avoir 
rinformation la plus a jour, 

Mode Serveur 

Dans le mode serveur, le processeur XSLT est charge en tant que thread (processus 
leger), etil peutetre invoque par uneAPI Java adequate(generalementl'API TrAX) pour 
generer des pages HTML (ou PDF) a la volee. Typiquement, le serveur HTTP regoit 
une requete, et uneservletou unepageASP va chercher une page X M L (qui contient une 
reference a la feuille de style XSLT a charger). Cette page XM L est transmise au thread 
XSLT qui va la transformer en HTM L, en utilisant au passage des donnees annexes (par 
exemple le resultat d'une requete SQL). U ne autre possibilite est que le resultat du traite- 
ment de la requete soit un ensemble d'objets (J ava, par exemple) qui resument la reponse 
a envoyer au cl lent. Cet ensemble d'objets J ava peut alors servir de base a la construction 
d'un arbre DOM representant un document XML virtuel qui sera lui meme transmis au 
thread X SLT pour etre transforms en HTM L et renvoye vers le client. 

Ce genre de solution fonctionne tres bien, mais a tendance a consommer des ressources 
sur I e serveur. II est certain que dans I 'ideal, il vaudrait mieux demander au client defai re 
lui-meme la transformation XSLT, mais ce n'est pas possible actuellement, a cause de la 
grandedisparite des navigateurs vis-a-vis du support de XSLT 1.0 

M eme avec IE5, il faut installer le module M SXM L3 pour que cela fonctionne, sinon le 
dialecteXSL integre par defaut a IE5 esttellementeloigne deXSLT 1.0, qu'on peut dire 
que ce n'est pas le meme langage. 

Actuellement la seule solution viable est done la transformation sur I e serveur, parceque 
c'est la seule qui permet de s'affranchir de la diversity des navigateurs ; il n'y a que si 
I'on travaille dans un environnement intranet, ou les postes clients sont configures de 
fafon centralisee, que I'on peutenvisager dediffuser sur lereseau du XM L a transformer 
a I'arrivee. 

Processeurs courants 

L'API TrAX (Transformation API forXML) est uneAPI qui permet de lancer des trans- 
formations XSLT au travers d'appels de methodes Java standard. JAXP (Java API for 
XML Processing), de Sun M icrosystems, est uneAPI complete pour tout ce qui esttrai- 
tement XM L, et comporte une parti e « transformation » conforme aux specifications de 
TrAX. Les processeurs dont i I est question ci-dessousimplemententl'API TrAX, 

En mode Serveur, on retrouve les deux processeurs Saxon etXalan, qui peuventtous les 
deux etre appeles depuis une application J ava, via des appels TrA X , et notamment depuis 
une servlet. Cocoon, produit par Apache, est un frameworl< integrant, grosso modo, un 
serveur HTTP, un moteur de servlets, et un processeur XSLT (Xalan). 
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Typologie des utilisations d'XSL 

II y a au moinstrois grands domaines oil lelangageXSL peut intervenir : 

• dans les applications Internet ; 

• dans les applications documental res ; 

• dans les applications d'echanges d'informations entre systemes heterogenes et repartis. 

La figure 1-2 montre une possible architecture d'application Internet, avec les divers 
endroits ou XSL peut (eventuellement) intervenir. Actuellement, la tendance est plutot 
d'utiliser XSL pour generer des pages HTML dynamiques, mais ce n'est qu'une ten- 
dance, et de nombreuses applications ont ete construites sur des architectures utilisant 
XSLT defagon plus importante : il serait tout a fait possibled'i magi ner une architecture 
dans laquelle les objets metier de I 'application Internet sont connectes a des gisements de 
donnees repartis (par exemple via J DBC), cette connexion se faisant par I'intermediaire 
d'objets DOM (Document Object Model) qui sont adaptes et transformes par un ou 
plusieurs processus XSLT. 

Note 

La connexion via JDBC a une base de donnees est une possibilite, mais ce n'est pas ia seuie, car ii y a des 
extensions, notamment avec Xaian et Saxon, qui permettent a une feuille de style de se connecter directement 
a une base de donnees relationnelle. 
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Figure 1-2 

Divers emplois d' XSLT dans une application Internet. 
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Les applications documentaires recouvrent un vaste champ d'applications qui nefont pas 
forcement partie du domaine strictement informatique ; citons par exemple le domaine 
de la litterature et les sciences humaines, avec des projets comme laTEl (Text Encoding 
Initiative, www.tei-c.org) ou celui de la composition electronique (PDF, Postscript) de 
textes anciens ou modernes dans des langues peu communes (grec ancien, arabe ancien, 
Sanscrit, copte, ecriture hieroglyphique, etc.) : voir par exemple www.fiuxus-virus.com/fr/ 
what-critical.htmi . 

Dans un domaine plus familier aux informaticiens, XSL intervient dans les chalnes de 
production plus ou moins automatisee de documentations techniques ou commercial es et 
marl<eting ; un exemple simple etant la production d'un document desynthese a parti r de 
donnees au format XML extraites d'une base de donnees, qui sont ensuite mises en 
forme par XSLT et XSL-FO, et donnent au final un document PDF ou Postscript (voir la 
figure 1-1 , a la section Le langage XSL, page 2). 

II faut citer aussi DocBook (fittp://docbook.sourceforge.net), dont on reparlera d'ailleurs 
dans la suite de ce livre, qui est un systeme complet et gratuit pour rediger de la docu- 
mentation (rapports, articles, livres, documents structures, etc.) au format XML, 
DocBook delivre des sorties en HTM L (previsualisation) ou en FO, que Ton transforme 
ensuite en PD F, par exemple (cette derniere transformation se faisant grace a un proces- 
seurFO comme FOP, X BP ouRenderX). 

Enfin, I e domaine de I'echange de donnees entre systemes heterogenes et repartis concerne 
plusieurscourantsd'activite, notamment celui del'EDI (Electronic Data Interchange, ou 
echangede donnees informati Sees), del'EAl (EnterpriseApplication Integration), etdes 
Web SerylzeS (www.w3.org/TI^/wsdl, www.w3.org/TR/soap12-part1, www.xmibus.com). 

Dans tous les cas, de information est echangee au format X M L, etdes transformations 
XSLT permettent d'adapter les donnees propres a un systeme pour les conformer a une 
syntaxe (DT D , X M L schemas, etc.) a I aquel I e adhere une certai ne communaute d' uti I i sa- 
teurs. 



Un avant-gout d'XSLT 

Donner un apergu du langage XSLT n'est pasdu tout evident. Pour un langage comme C 
ou Java, c'est assez facile de donner quelques exemples donnant une premiere impres- 
sion, parce que ce sont des langages qui ressemblent a d'autres : on peut done proceder 
par comparaison en montrant par exemple un programmeVisual Basic et son equivalent 
en Java, ou un programme Pascal et son equivalent en C. Pour XSLT, il n'y a aucun lan- 
gage un tant soit peu equivalent eta peu pres bien connu qui permetted'etablir une com- 
paraison. Seuls des langages fonctionnels ou declaratifs comme Prolog, CamI ou Lisp 
donnent une bonne base de depart qui permet de s'y retrouver, mais encore faut-il en 
avoir I 'experience... 

Si on ne I'a pas, il n'est guere possible desefier a son intuition pour deviner I'effet d'un 
programme, notamment au tout debut de la prise de contact avec ce langage. 1 1 y a nean- 
moins un angle d'attaque, qui ne donne pas un panorama complet du langage, loin s'en 
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faut, mais qui permet au moins de voir certains aspects, et de comprendre dans quelles 
directions i I faut partir pour comprendre ce qu'i I y a a comprendre dans ce langage. 

Nous allons done commencer par voir ce qu'on appelle une feuille de style simplifiee 
(Simplified Stylesheet) ou Litteral Result Element As Stylesheet, comme I'appelle fort 
doctement la specification XSLT 1,0, 

L'avantage est qu'une feuille de style simplifiee utilise une version tellement bridee du 
langage X SLT que I 'on peut assez facilement deviner ce que fait une tel le feui lie de style 
sans quedes explications tres detail lees soientforcement necessaires, 

M ais I'inconvenient est que I'on ne peut pas faire grand chose de plus que ce qu'on va 
montrerdanscetapergu, 

Remarque 

Une feuille de style simplifiee n'est jamais necessaire : 11 n'y a jamais rien ici que I'on ne puisse faire avec une 
vraie feuille de style. 

U ne feuille de style simplifiee peut rendre service aux auteurs de pages HTML possedant 
peu de competences en programmation, dans la mesureou cela leur permet d'ecrire assez 
facilement des pages dynamiques. La seule contrainte a respecter absolument, qui 
contredit peut etre la pratique courante, est que le document HTM L a ecrire doit respec- 
ter la syntaxe XM L, c'est-a-dire qu'il faut employer du XHTM L : toute balise ouverte 
doit etre refermee, et les valeurs d'attributs doivent etre enfermees dans des apostrophes 
ou des guillemets, 

Avant de passer a I 'exemple proprement dit, insistons encore une fois sur le fait que cette 
notion de feuille de style simplifiee n'est presentee ici que pour vous donner une pre- 
miereideedu langageXSLT, II n'y a aucune autre justification ason usage, etplusjamais 
nous n'en reparlerons dans la suite de ce livre, A utant dire qu'une feuille de style simpli- 
fiee n'a pas grand interet dans la pratique,,, 

Exemple 

Pour montrer comment generer une page dynamique avec une feuille de style simplifiee, 
nous al Ions prendre un exemple, et supposer que nous voulons obteni r une page telle que 
cellequi estmontreealafigurel-3, 

Cette page est produite a partir d'un fond qui comporte essentiellement de I'HTML 
XMLise : 

AnnonceConcert.xsl 

<?xml version="1.0"?> 

|<html xmlns:xsl="http://www. w3.org/1999/XSL/Transform" xsl :version="1.0"> 
<head> 
<title>Les "Concerts Anacreon"</title> 



Figure 1-3 

Une page HTML 
a generer 
dynamiquement. 
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3 Les «Conceits Anacreon> - Microsoft Internet Explorer 



□jx] 



Rchief Edition Afficiiage Favoris Outils 



Les «Conceii:s Anacreon» presentent 
Conceit le Jeudi 17 Janvier 2002 20H30 

Cha^elle des Ursules 

Ensemble «A deux violes esgales» 

Jonathan Dunford , Basse de viole 
Sylvia Abramowicz , Basse de viole 
BenjaininPenrot, Theorbe 
Freddy Eichelberger, Clavecin 

Oeuvres de M. Marais, D. Castello, F. Rognoni 



</heacl> 
<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 



<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of select="/Annonce/Lieu"/> 
</H4> 

<H2 align="center"> 

Ensemble "<xsl :value-of sel ect="/Annonce/Ensembl e"/>" 
</H2> 



<xsl :for-each sel ect="/Annonce/Interprete"> 
<P> 
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<xsl :val ue-of select="./Nom"/>, 

<xsl :value-of select="./Instrument"/> 

</p> 
</xsl :for-each> 

<H3> 

Oeuvres de <xsl :val ue-of select="/Annonce/Conipositeurs"/> 
</H3> 

</body> 
</html> 

Cefichier HTML est en realite un fichier XM L, commelemontrela premiere I igne, dont 
I'element racine est I 'element <htmi>, qui introduit done un document HTM L. Les deux 
attributs accompagnant cet element sont obligatoires : si vous voulez ecrire votre propre 
exemple, vous pouvez recopier les deux premieres 11 gnes telles quel les, sans vous poser 
de question. Le premier attribut est en fait une definition de domaine nominal, c'est-a- 
dire la definition d'un jeu devocabulaire identifie par une URL ad hoc, et abregeesous la 
forme d'un prefixe qui est ici xsi. Cette URL n'est pas du tout utilisee en tant qu'URL, 
C est juste une chaine de caracteres convenue qui represente symbol iquement lejeu de 
vocabulaire XSLT ; cette chaine de caracteres en forme d'URL a ete determinee par le 
W3C, et le processeur XSLT qui va lire ce fichier ne prend en compteen tant qu'instruc- 
tion XSLT que les elements XM L dont le prefixe reference cette URL. II est done abso- 
lument impossible de changer quoi que ce soit a cette declaration de domaine nomi nal . II 
en estdememepourl'attributxsi :version, du moins tant que la specification XSLT 2.0 
ne sera pas parvenue au stade tie Recommendation : pour I 'instant, done, la seule valeur 
possible est 1.0. 

Le reste du fichier est essentiellement du XHTML, avec 5a et la des instructions XSLT : 
I'instruction <xsi :for-each>, et I 'instruction <xsi :vaiue-of> dans I ecas present, 

Ces instructions ont pour but d'alimenter le texte HTM L en donnees provenant d'un 
fichier XML auxiliaire. Ces donnees ne sont pas directement presentes dans le texte 
XHTM L, afin de pouvoir generer autantde pages differentes que necessai re, ayanttoutes 
le meme aspect : 11 suffit pour cela d'avoir plusieurs fichiers XML differents. 

Dans notre exemple, I e fichier XML auxiliaire est celui-ci : 

Annonce.xtnl 

<?xml version="1.0" ?> 

<Annonce> 

<Date>Jeudi 17 Janvier 2002 20H30 
</Date> 

<Lieu>Chapene des Llrsules</Lieu> 



<Enseinble>A deux violes esgales</Ensemble> 
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<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Noni> Sylvia Abramowicz </Nom> 
<Instruiiient>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Noni> Benjamin Perrot </Nom> 
<Instrument>Theorbe</Instrument> 
</Interprete> 

<Interprete> 

<Noni> Freddy Eichelberger </Noni> 
<Instrument>Cl avecin</Instrument> 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello. F. Rognoni 
</Compositeurs> 

</Annonce> 

La generation de la page HTM L dynamique consisted lancer un processeur XSLT en lui 
fournissant deux fichiers : d'une part lefichier dedonneesXM L Annonce.xmi, et d'autre 
part le fichier programme AnnonceConcert .xsi . 

Nous supposonsquenoussommesen modeCommande (voir Mode Commande, page 5), 
et que le processeur Choi si est Saxon. La lignede commande pour obtenir la page HTM L 
annonce.html serait alors celle-ci : 

Ligne de comtnande (d'un seul tenant) 

Java -classpath saxon.jar com. icl .saxon. Stylesheet 

-0 annonce.html Annonce.xmi AnnonceConcert. xsl 



Note 

Ceux qui ne voudraient pas installer une machine virtuelle Java pourraient utillser ici Instant Saxon. 

Et le fichier obtenu serait celui-ci (voir aussi la figure 1-3) : 

Annonce.htnil 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 
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<title>Les «Concerts Anacréon»</title> 
</head> 
<bocly> 

<H1 al ign="center">Les «Concerts Anacréon» 
pr&eacute:sentent</Hl> 
<hr><br><Hl al ign="center"> 

Concert le Jeudi 17 Janvier 2002 20H30 

</Hl> 

<H4 al ign="center">Chapel 1 e des Ursul es</H4> 
<H2 al ign="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford , 

Basse de viole 

</p> 

<p> Sylvia Abramowicz , 

Basse de viole 

</p> 

<p> Benjamin Perrot , 

Th&eacute:orbe 

</p> 

<p> Freddy Eichelberger , 
CI avecin 

</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 

Avantdecontinuer, il fautici faireuneremarqueimportante : le document source, malgre 
les apparences, est le fichier XML Annonce.xmi ; le processeur XSLT transforme ce 
document XML en un document HTML annonce.htmi, par I'intermediaire d'un pro- 
gramme XSLT contenu dans le fichier AnnonceConcert.xsi : le fichier auxiliaire de 
donnees est en fait, du point de vue XSLT, le document principal, et ce qui semblait 
n'etre que le modele de fichier HTM L a produire est en realite le programme XSLT a 
executer, 

Extraction individuelle (pull processing) 

Regardonsmaintenantdepluspreslefonctionnementdu programmeXSLT : il estessen- 
tiellement base sur le principede I'extraction individuelle (connu en anglais sous le nom 
de pull processing). Typiquement, le debut du programme est entierement base sur ce 
principe : 
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<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 
<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of select="/Annonce/Lieu"/> 
</H4> 

<H2 align="center"> 

Ensemble "<xsl :value-of sel ect="/Annonce/Ensembl e"/>" 
</H2> 

Tout cetexte est recopietel quel parleprocesseurXSLT dans I e document HTM L resul- 
tat, a I'exception des instructions <xsi :vaiue-of> qui sontdes instructions d'extraction 
individuelle : dies sont done remplacees par leur valeur, valeur qui est prelevee (ou 
extraite, d'ou cette notion d'extraction individuelle) dans lefichier dedonneesXM L, 

Le langage XPath 

Le probleme est naturellement de definir a quel endroit du document X M L se trouve la 
donnee a extraire. C'est la qu'intervient le langage XPath, qui permet de referencer des 
ensembles d'elements, d'attributsetdetextes figurant dans un document XM L. 

Par exemple, I'expression XPath /Annonce/Date selectionne tous les elements <Date> 
qui se trouvent directement rattaches a un element <Annonce> racine du document. Si 
vous regardez le document XML, vous verrez qu'il n'y en a qu'un qui reponde a la 
description. L'instruction : 

<xsl :value-of sel ect="/Annonce/Date"/> 

sera done remplacee par sa valeur, c'est-a-dire par letexte trouve dans I'element <Date> 
Selectionne, a savoir : 



I Jeudi 17 Janvier 2002 20H30 
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Remarque 

Lanalogie entre une expression XPath telle que /Annonce/Date et un chemin Unix d'acces a un fichier a 
souvent ete soulignee. Dans notre exemple, I'expression XPath lue comme un cliemin Unix voudrait dire « ie 
ficliier (ou repertoire) Date se trouvant dans Ie repertoire Annonce situe a la racine du systeme de fichiers ». 
Cette analogie est a mon avis plus dangereuse qu'utile. En effet il y a une enorme difference entre une arbores- 
cence de fichiers et une arborescence d'elements XML : il ne peut jamais y avoir deux fichiers ayant Ie memo 
nom dans un memo repertoire, alors qu'il peut fort bien y avoir plusieurs elements de memos noms rattaches au 
memo element. Dans notre fichier XML d'exemple, voyez comment interpreter I'expression /Annonce/Inter- 
prete : il s'agit de I'ensemble de tous les elements <Interprete> directement rattaches a la racine 
<Annonce>. Cette possible multiplicite d'elements intervient a tous les niveaux : dans une expression comme 
/Annonce/Interprete/Instrument, rien n'interdit qu'il y ait plusieurs <Interprete> par <Annonce> (deja 
vu), et plusieurs <Instrunient> par <Interprete> (il n'y a pas d'exemple dans notre fichier XML, mais cela 
pourrait arriver : voir plus bas). 

La consequence, et c'est la ce qu'on voulait montrer, est qu'il est des lors impossible de lire une expression 
XPath comme on lirait un chemin Unix : c'est en cela que I'analogie est mauvaise et nocive. Un chemin Unix se 
lit normalement, de gauche a droite. Mais Ie meme chemin, considere comme une expression XPath, doit se lire 
a I'envers, car c'est Ie seul moyen de preserver la multiplicite des elements selectionnes : /Annonce/Inter- 
prete/Instrument doit se lire « les instruments qui sont rattaches a des interpretes qui sent rattaches a la 
racine Annonce ». 



En appliquant cette instruction xsi:vaiue-of aux divers cliemins XPatli concernes, on 
voit done facilement que Ie fragment de programme ci-dessus va produire Ie resultat 
suivant : 

<head> 

<title>Les "Concerts Anacreon''</title> 
</head> 

<body> 

<H1 align="center''>Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center''> 

Concert le Jeudi 17 Janvier 2002 20H30 
</Hl> 

<H4 align="center"> 

Chapelle des Ursules 
</H4> 



<H2 align="center"> 

Ensemble "A deux violes esgales" 
</H2> 
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La suite du programme comporte une repetition <xsi :for-each> : 

<xsl :for-each sel ect="/Annonce/Interprete"> 
<P> 

<xsl :value-of sel ect=" . /Noni"/> , 

<xsl :value-of sel ect=" . /Instrument"/) 

</p> 
</xsl :for-each> 

Ici, instruction <xsi :for-each> selectionne un ensemble d'elements XM L contenant 
tous les <interprete> directement rattaclies a la racine <Annonce> ; et dans le corps 
decette repetition, on dispose d'un element courant, qui est bien sur un <interprete>, 
que I 'on peut referencer dans une expression XPath par la notation " .". Ainsi, I 'expres- 
sion Xpath "./Nom" veut dire: « tous les <Nom> rattaches directement a I'element 
<interprete> courant ». Comme un tel <Nom> est unique, I'instruction : 

I <xsl :value-of select="./Nom"/> 

est done remplacee par la valeurdu nom del'interprete courant, etil en est dememe pour 
I'instruction : 

I <xsl :value-of select="./Instrunient"/> 

Au total, cette repetition produit la sequence suivante dans le document resultat : 

<p> Jonathan Dunford , 

Basse de viole 

</p> 

<p> Sylvia Abramowicz , 

Basse de viole 

</p> 

<p> Benjamin Perrot , 

Théorbe 

</p> 

<p> Freddy Eichelberger , 
Clavecin 

</p> 

Finalement, on obtientdonc lefichier HTM L deja montre plus haut. 
Autre exemple 

Les feuilles de style simplifiees se resument en gros a ce qu'on vient de voir ; 11 n'est 
guere possibledefaire plus, a part utiliser quelques instructions XSLT complementaires, 
par exemple un <xsi :if>, Pour illustrer ceci, supposons maintenant que lefichier XM L 
a traiter soit constitue ainsi : 

Annonce.xml 

|<?xml version="1.0" ?> 
<Annonce> 
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<Date>Jeucli 17 Janvier 2002 20H30 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 



<Enseinble>A deux violes esgales</Ensemble> 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 
<Instrument>Theorbe</Instrument> 
<Instrument>Luth</Instruinent> 
<Instrument>Chi tarrone</Instrument> 
<Instrument>\/i huel a</Instrument> 
< Inst rument>Angel ique</ Inst rument> 

</Interprete> 



<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Cl avecin</Instruinent> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



</Annonce> 



Leprobleme a trailer, ici, estqu'il peuty avoir une listed'instruments pour cliaque inter- 
prete. 0 n veut que I e resultat soi t eel ui montre a I a figure 1-4. 

Fondamentalement, il n'y a rien de cliange au programme. Simplement, il va falloir pla- 
cer une deuxieme instruction de repetition, pour donner la listedes instruments par inter- 
prete, ce qui complique un peu les choses, car une liste implique la presence de 
separateurs d'elements (ici, c'est une virgule). 

Cette virgule doit apparaitre apres chaque nom d'instrument, sauf le dernier : d'ou la 
necessite d'utiliser une instruction <xsi :if> qui va nous dire si l'<instrument> courant 
est le dernier ou non. 
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Figure 1-4 

Une page HTML un 
peu plus compliquee 
a generer 
dynamiquement. 
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Concert le Jeudi 17 Janvier 2002 
20H30 

Chapelle des Ursules 

Ensemble «A deux violes esgales» 

Jonathan Dunford (Basse de viole ) 
Sylvia Abramowicz (Basse de viole ) 

Benjamin Perrot (Theorbe, Luth, Chitarrone, Vihuela, Angelique ) 

Freddy Eichelberger ( Clavecin ) 

Oenvres de M. Marais, D. Castello, F. Rognoni 



AnnonceConcert.xsl 

<?xml version="1.0" ?> 

<html xml ns:xsl ="http: //www. w3.org/1999/XSL/Transforin" 
xsl :version="1.0"> 

<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 

<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le <xsl :val ue-of sel ect="/Annonce/Date"/> 
</Hl> 

<H4 align="center"> 

<xsl :value-of select="/Annonce/Lieu"/> 
</H4> 



<H2 align="center"> 
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Ensemble "<xsl :val ue-of select="/Annonce/Ensemble"/>" 
</H2> 

<xsl :for-each select="/Annonce/Interprete"> 
<P> 

<xsl :value-of select="./Nom"/> 

<xsl:text> ( </xsl:text> 

<xsl :for-each select="./Instrument"> 

<xsl :value-of select="."/> 

<xsl:if test="position( ) last()"> 
<xsl:text>, </xsl:text> 

</xsl :if> 
</xsl :for-each> 
<xsl:text> ) </xsl:text> 

</p> 
</xsl :for-each> 

<H3> 

Oeuvres de <xsl :value-of select="/Annonce/Compositeurs"/> 
</H3> 

</bocly> 
</html> 

Ici la premiere instruction de repetition <xsl :for-each select="/Annonce/Inter- 

prete"> selectionne un ensemble d'elements <interprete>, et chacun d'eux devient tour 
a tour l'<interprete> courant, note ". " dans lesdeux premiers attributs select qui vien- 
nent ensuite : 

• seiect="./Nom" : selectionne tous les <Nom> qui sont directement rattaches a 
l'<interprete> courant (11 n'y en a qu'un) ; 

• seiect=" ./Instrument" : selectlonne tous les <instrument> qui sont directement 
rattaches a l'<interprete> courant (11 peuty en avoir plusieurs). 

La deuxieme instruction de repetition <xsi :for-each> produit done une liste d'instru- 
ments, en copiant dans le document resultat le texte associe a l'<instrument> courant, et 
en lefaisant suivred'une virgule, sauf si l'<instrument> courant est I e dernier del a liste. 

Par ailleurs on remarque I'utilisation de instruction <xsi :text>. Cette instruction est 
tres utile, maisson rolerestetresmodeste, en tout cas ici. Ellesertadelimiter exactement 
un texte litteral a produire dans le document resultat, sans que des espaces, tabulations, et 
autres sauts de ligne ne viennent s'ajouter de fa^on intempestive au resultat. 

La difference entre : 

<xsl :value-of select="./Noni"/> 
<xsl:text> ( </xsl:text> 



I 

et: 



<xsl :value-of select^" ./Nom"/> 
( 



Un avant-g inil il ii I I M 
ChapitreY^^ 

est que dans le premier cas, on voit qu'il y a exactement un espace avant la parenthese, 
alors que dans le deuxieme, on voit qu'il y en a plusieurs (combien ? difficile a dire) et 
qu'il y a aussi un saut de ligne. On pourrait se passer de I'instruction <xsi :text> en 
ecrivant : 

I <xsl :val ue-of sel ect=" . /Noni"/> ( <xsl :for-each select="./Instrument"> 

mais ce n'est pas tres agreable, car cela impose la presentation du programme en empe- 
chant de placer des sauts de lignes ou on veut afin d'aerer la disposition. 

Voici pour finir le fichier HTML obtenu (on pourra comparer avec la figure 1-4), en deux 
versions : la premiere obtenue avec le programme X SLT tel qu'il apparait avant (fichier 

AnnonceConcert .xsl ) : 

annonce.htinl 

<html> 
<head> 

<nieta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 

<title>Les «Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">Les «Concerts Anacréon» 

pr&eacute:sentent</Hl> 
<hr><br><Hl al ign="center"> 

Concert le Jeudi 17 janvier 2002 20H30 

</Hl> 

<H4 align="center">Chapelle des Ursules</H4> 
<H2 al ign="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford ( Basse de viole ) </p> 
<p> Sylvia Abramowicz ( Basse de viole ) </p> 

<p> Benjamin Perrot ( Théorbe, Luth, Chitarrone, Vihuela, Angelique ) 
</p> 

<p> Freddy Eichelberger ( Clavecin ) </p> 
<H3> 

Qeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 
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Et la deuxieme version : 

annonce.html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=utf-8"> 



<title>Les «Concerts Anacr&eacLite;on»</title> 



<H1 al ign="center">Les «Concerts Anacréon» 

présentent</Hl> 
<hr><br><Hl al ign="center"> 



</H2> 

<p> Jonathan Dunford 
( 

Basse de viole 
) 

</p> 

<p> Sylvia Abramowicz 




</head> 
<body> 



Concert le Jeudi 17 Janvier 2002 20H30 



</Hl> 

<H4 al ign="center">Chapel 1 e des Ursul es</H4> 
<H2 al ign="center"> 



Ensemble «A deux violes esgales» 



Basse 



de viole 



</p> 

<p> Benjamin Perrot 



Théorbe 



Luth 



Chitarrone 



Vi hue] a 



Angelique 



</p> 

<p> Freddy Eichelberger 



Clavecin 
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</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 

Cette deuxieme version est obtenue en supprimant les instructions <xsi :text> du pro- 
gramme precedent, comme ceci : 

<xsl :for-each sel ect="/Annonce/Interprete"> 
<P> 

<xsl :val ue-of sel ect=" . /Nom"/> 
( 

<xsl :for-each sel ect=" . /Instrument"> 
<xsl :val ue-of select="."/> 
<xsl:if test="position( ) != last()"> 

</xsl :if> 
</xsl :for-each> 
) 

</p> 
</xsl :for-each> 

Conclusion 

Nous venonsdevoircequ'on peut fai re avec la notion defeuilledestylesimplifiee. Cela 
se resume a de I'extraction individuelle (pull processing), agrementee de la possibilite 
d'utiliser quelques instructions d'XSLT, permettantde fai redes repetitions, des tests, des 
choix multiples, et quelques autres traitements complementaires. 

M ais 11 manque essentiellement le pendant de I'extraction individuelle, qui est la distri- 
bution selective (ou push processing), qui donne toute sa puissance a X SLT (mais qui en 
faitaussi la difficulte). II manqueegalementdes instructions qui sontinterdites(ou plutot 
impossibles) avec lesfeuillesdestylesimplifiees, notammenttoutes les instructions dites 
de premier niveau : cela inclut la declaration de variables globales, de cles associatives 
(<xsi :key>), d'i nstructions d'importation d'autres feuilles de style, et la definition de 
model es nommes (qui sont des structures jouant a peu pres le meme role que les fonc- 
tions ou les sous programmes dans les autres langages). Avouez que cela finit par faire 
vraiment beaucoup, et que dans ces conditions, les feuilles de style simplifiees n'ont pas 
beaucoup d'interet, a part d'etre tres simples etfaciles a comprendre intuitivement. M ais 
pour quelqu'un qui connait bien XSLT, on peut aller jusqu'a dire qu'elles n'ont stricte- 
ment aucun interet par rapport aux vraies feuilles de style XSLT. 

Nousavonsvu au passage que lelangage XSLT possedeson proprejeu d'instructions, au 
format XML, mais identifie par le domaine nominal http://www.w3.org/i999/xSL/Transform ; 
et qu'on y utilise un autre langage, le langage XPath, qui n'a hen a voir avec XML, 
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Celangage, qui permet de selectionner divers ensembles de fragments d'un document 
XM L, est en fait nettement plus complique quecequ'on a pu montrer dans les exemples 
precedents, et il faudra un gros chapitre pour en venir a bout. 

Parcours de lecture 

Nous venons de voir I'interet du langage XSLT, a quoi il sert et ou il se situe. Bien que 
partie integrante deXSL, XSLT est un langage qui peut etre considere comme indepen- 
dant. De plus il est extremement different, dans sa philosophie et dans les competences 
qu'il meten jeu, du langageXSL-FO, I'autre versantdeXSL. 

C'est pourquoi dans la suite de ce livre, on se consacrera exclusivement a XSLT lui- 
meme, et a son compere X Path. 

Nous verrons done d'abord XPath, puis les principes du langage XSLT. Le style adopte 
est un style a I'oppose d'un manuel de reference, en ce sens qu'on cherche plus afavori- 
ser la comprehension du sujet que I'exhaustivite du propos. M ais ceci doit etre tempere 
par le fait que pi us on avancedans la lecture, et plus on en salt : on est done plusa meme 
d'accepter des details ou des subtilites vers la fin de la presentation que vers I e debut. 

Si vousetes presse et voulez lire I'essentiel pour comprendreXSLT, sans entrer dans les 
details, et pour comprendre le mode de pensee a adopter pour etre en phase avec ce lan- 
gage, il n'y a qu'un chapitre a lire : le chapitre Am cceurdu langage XSLT, page 75. 

Apres avoir fait le tour de la plus grande partie du langage en quelques chapitres, on 
s'interessera a la notion de « pattern » de conception XSLT, en mettant en evidence des 
grands themes qui reviennent frequemment, aussi bien dans le domaine microscopique 
dela programmation par des techniques parti culieres, que dans celui plus macroscopique 
de la transformation d'arbres. 

Enfin, dans les annexes, on trouvera des elements complementaires, notamment la des- 
cription sommaire de quelques instructions dont la comprehension ne pose pas de diffi- 
culte particuliere, ou dont la comprehension est plus du ressort detests effectifs avec un 
processeur XSLT que de celui d'une lecture argumentee. On y trouvera aussi des ele- 
ments syntaxiques, et une description des foncti ons predefinies XPath etXSLT, 

A noter que dans ce livre, les exemples fournis ont tous ete testes avec les processeurs 
X alan et Saxon, et que le mode de foncti onnement sous-jacent des exemples proposes est 
lemodeCommande ; cela n'a aucune influence sur lasemantiquedu langage XSLT, mais 
eel a permet de fixer les idees. 



Premiere Partie 



Les langages XPath 
et XSLT 




Chapitre2. 




.... 29 


C hapitre 3. 


AucoeurdulangageXSLT 


.... 75 


Chapitre4. 




.... 127 


C hapitre 5. 




.... 167 


C hapitre 6. 




.... 249 


C hapitre 7. 


Decoupage d'une application X SLT 


.... 373 




Guide de lecture 

Chapitre XPath 

Le chapitre sur XPath est globalement tres important pour la comprehension du reste. 
Notamment, il est absolument indispensable d'avoir toujours present a I 'esprit le modele 

arborescent d'un document XML VU par XPath (Modele arborescent d'un document 

XML vu par XPath, page 30), Car ce modele est a la base detous les raisonnements divers 
et varies en XSLT, 

L a section suivante, XPath, un langage d' expressions, page 40, peut etre ignoree en pre- 
miere lecture. Certains passages, dans la suite du livre, y font reference, et on pourra 
eventuellement attendre d'y etre invite ou d'avoir un probleme lie a I'ecriture ou la lec- 
ture d'une expression pour aller voir cette section. Dans beaucoup decas simples, I 'intui- 
tion peut suffire, au moins pour lire une expression. 

Les trois sections SUivanteS (Principes de la construction d'un chemin de localisation, 
page 47, Etape de localisation, page 48, Chemins de localisation, page 62) representent 
le coeur d'XPath : elle sont essentielles pour la comprehension d'XPath et d'XSLT. 
Notamment la section Lecture d'un chemin de localisation sans predicat, page 64, in- 
diqueun algorithme pour lire les chemins XPath ; cela aide beaucoup au debut, quand on 
n'a pas encore I 'habitude de manipuler lesetapes de localisation. 

La section suivante. Formes courtes des chemins de localisation, page 68, indique leS 

abreviations standards utilisees en XPath. Cette section est egalement incontournable, 
car ces abreviations sont presque toujours utilisees dans la pratique. 

La derniere section, Variantes syntaxiques, page 70, pourra etre sautee en premiere lec- 
ture, car elle donne des elements assez subtils, indispensables a mettre en oeuvre dans 
certains cas, mais heureusement assez rares. 

Chapitre Au coeur d'XSLT 

Ce chapitre est le chapitre essentiel pour la comprehension generale du langage XSLT. 
II s'opposefortement a I 'introduction vuea la section Un avant- gout d'XSLT, page 9, en 
ce sens que I'on ne fait pas appel ici a I'intuition, mais qu'au contraire, on demonte le 
mecanisme de traitement specifie par XSLT. Ce chapitre, une fois lu, permet la compre- 
hension globaledetoutXSLT : le reste est constitue d'ajouts, defacilites, de details, etc., 
mais il n'y a aucun mecanisme fondamentalement nouveau. Seules trois instructions y 

SerontVUeS : xsl :template, xsl :value-of, etxsl : apply-templ ates, parce qu'elles SOnt 

au Coeur du modele de traitement, de meme que la notion de motif et de concordance de 
motif (pattern matching), qui sera vue de fagon tres detaillee a cette occasion, 

Chapitres sur les instructions XSLT (transformation, programmation,creation) 

Le modele de traitement du langage XSLT etantvu, le reste du langage consiste en divers 
ajouts (des instructions) permettant d'exploiter pleinement la puissance de ce modele de 
traitement. II est alors possible de grappiller en fonction des besoins, bien que les trois 
chapitres soient organises de telle sortequ'il n'y ait pas de references avant. Une lecture 
lineaire est done recommandee, mais elle n'est pas obligatoire. 



Ces instructions sont classees en trois categories : transformation, programmation et 
creation. Cliaque categorie correspond a un cliapitre. Ces trois cliapitres sont presentes 
suivant un plan assez regulier, dans lequel cliaque instruction (mis a part quelques ins- 
tructions comme xsi :template, xsl :value-of, etxsl : apply-templ ates, qui neSOntpaS 
concernees parce qu'elles ont ete deja vues au cliapitre Au cceur du langage XSLT, 
page 75, ou quelques autres qui sont extremement simples) sera presentee comme ceci : 

• bande-annonce; 

• syntaxe; 

• regie XSLT typique; 

• semantique; 

• exemples divers ; 

• eventuellement variantes syntaxiques et exemples. 

La section bande-annonce donne un apergu de instruction sur un exemple simple, le 
plus souvent (mais pas toujours) repris plus loin dans la suite des explications. Cette 
bande-annonce permet de se faire rapidement une idee intuitive de instruction. 

La section syntaxe donne la forme de i'instruction avec ies eventuelles contraintes a res- 
pecter. 

La section regie XSLT typique donne une forme de regie XSLT (xsi :tempiate) dont ie 
modelede transformation emploietypiquement I'instruction decrite. 

La section semantique indique I'effet de I'instruction, c'est-a-dire la fagon dont elle est 
instanciee. 

Les exemples viennent ensuite: certains sont directs, d'autres sont I'occasion de 
quelques digressions induites par des difficultes inattendues. 

Les variantes syntaxiques introduisent generalement des possibilites nouvelles offertes 
par des attributs facultatifs de I'instruction decrite. 

Si I 'on est presse et que I 'on souhaite se contenter d'une lecture de premier niveau, on 
pourra se contenter de lire la bande-annonce, la syntaxe, la regie XSLT typique, et de 
jeter un coup d'oeil a la semantique ; si I'on n'est pas presse ou quel'on revientsur cette 
instruction apres avoir bute sur une difficulte, on pourra lire la semantique plus en detail, 
et analyser les exemples qui viennent ensuite. 

Chapitre Decoupage d'une application XSLT 

Ce chapitre est un peu a part, dans la mesure oil il n'apporte aucune fonctionnalite nou- 
velle au langage XSLT, si ce n'est la fafon de decouper une application XSLT, soit pour 
la rendre plus facilement maintenable, soit pour rendre reutilisables certains de ses 
constituants. C'est done plutot un chapitre donnant quelques elements de Genie Logiciel 
en XSLT, qui peut evidemment etre ignore en premiere lecture si votre but est unique- 
ment, dans un premier temps, la realisation de transformations XSLT. 
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Le langage XPath 



Le langage XPath est standardise sous la forme d'une « W3C Recommendation » du 
16 novembre 1999. 

Cen'estpasun langage de la familleX M L : c'estun langage d'expression permettantde 
constituer des ensembles de noeuds provenant de I'arbre XML d'un document, XPath 
intervient dans XSLT d'une fagon tellement intriquee, qu'on pourrait croire qu'il nefait 
qu'un avec XSLT. M ais en fait, c'est un langage a part, parce que le W3C en a fait une 
brique intervenant dans d'autres langages, comme par exemple X Pointer (pour XSLT 
1.0) ouXQuery (pour XSLT 2.0). 

C'est un langage assez simple dans sa structure, puisqu'il se limite a des expressions, 
mais I 'interpretation de certaines expressions (complexes ou non) peut parfoisetre assez 
subtile. Heureusement, dans la pratique, les expressions XPath que I'on doit manipuler 
sont generalement assez simples, eten tout cas, deviennent assez vitefamilieres. 

Pour voir comment fonctionne X Path, il faut d'abord comprendre sur quoi repose son 
fonctionnement. X path etant fait pour traiter des documents X M L, 11 utilise un modelede 
representation arborescente d'un document XML, qui conditionne tout le reste; nous 
commencerons done par voir ce modele d'arbre. Ensuite, nous verrons comment chemi- 
ner dans un tel arbre, avec la notion de chemin de localisation, notion central e de X Path, 
impliquant elle-meme d'autres notions plus elementaires, telles que les axes de localisa- 
tion, les determinants, et les predicats. Ces elements sont les ingredients de base pour 
ecrire tiesetapes de localisation, dont I 'enchainement donne des chemins de localisation 
qui peuvents' interpreter en termesd'ensemblede noeuds del 'arbre traverse : XPath spe- 
cifie comment ecrire des chemins de localisation, et comment les interpreter pour obtenir 
des ensembles de noeuds. 
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Modele arborescent d'un document XML vu par XPath 

Nous allons expliquer ici comment X Path « voit» un document X M L, c'est-a-dire etu- 
dier la structure arborescente utilisee par XPath pour model iser un document XM L. Le 
modele arborescent utilise par XPath n'est pas necessairement celui qui est reellement 
implemente en memoire lors de I'execution d'un processeur XSLT ; c'est un modele 
conceptuel qui permet de fixer les idees et d'exprimer commodement les proprietes de ce 
langage, 

L'arbre manipule par X Path n'est pas different de I'arbre XM L du document ; simple- 
ment, des precisions sont apportees sur la nature de certains liens parent-enfant, ainsi que 
sur la nature des noeuds de I 'arbre. 

II y a sept types de noeuds possibles dans un arbre : 

• root : le type du noeud racine de I'arbreXM L du document, a ne pas confondre avec 
I 'element racine du document, qui est un element comme un autre, a part qu'il n'a pas 
d'element parent. L'element racine fait partie du document XML, alors que la racine 
root de I'arbre n'a pas de contrepartie visible dans le document XML, 

• element . le type d'un noeud element XML, 
<xxx> . . . </xxx> 

• text : le type d'un noeud textefaisant partie d'un element, 

... blabla ... 

• attribute : le type d'un noeud attribut d'element X M L . 

surf ace= ' 12m2 ' 

• namespace : le type d'un noeud domaine nominal permettant de qualifier les noms 
d'attributs ou d'elements intervenant dans certaines parties d'un document X M L, 

xml ns : txt="http : / /www. w3c . org/xml /schemas/Basi c-text . dtd" 

• processing-instruction : le type d'un noeud processing-instruction (directive de 
traitement), en principe adressee a un programme autre que le processeur XSLT lui- 
meme, 

<?cible argl arg2 . . . ?> 

• comment . le type d'un noeud commentaireXM L. 

<!-- ... --> 

II est possible d'obtenir la valeurtextuelleden'importe quel noeud ; eel a semble evident 
pour un noeud de type text ou attribute, mais c'est aussi possible pour tous les autres 
types, Parfois la valeur textuelle d'un noeud ne depend que du noeud en question, mais 
parfois elle depend aussi de ses descendants (cas d'un noeud de type element) ; cela 
depend en fait du type de noeud : un algorithme sera done donne pour chaque type, per- 
mettant de calculer cette valeur textuelle. 
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Nceud de type root 

Bien sur, un seul noeud peut etre de type root. A la racine sont attaches, dans un lien 
parent-enfant : I 'element raci ne du document XML proprement dit (que I 'on trouve apres 
le prologue), les instructions de traitement et les commentaires qui interviennent dans le 
prologue et apres la fin de I 'element racine du documentXM L (voir la figure 2-1). 



Exempl e 

<?xml version='1.0' encodings' ISO-8859-r standalone='no' 
<!DOCTYPE passacaille SYSTEM "Danse.dtd" > 
<?play audio amide. avi?> 
<passaca111e> 

</passacaille> 

<!-- fin du document --> 



?> 



Figure 2-1 

Un nceud de type 
root. 



processing 

instruction 

play audio armide.avi 




^ eiement 

[passacaille 

I 
I 



comment 

fin du document 



La valeur textuelle du noeud de type root est la concatenation des valeurs textuelles de 
tous ses noeuds descendants pris dans I'ordre de lecture du document. 



Nceud de type element 

II y a un noeud de type ei ement pour chaque element <xxx> du document X M L . A un 
noeud detype element sont attaches, dans un lien parent-enfant : les noeuds de type ele- 
ment, enf ants directs de I 'element considere, les noeuds detype processing instruction, 
comment, et text qui font partie du contenu de I'element considere (voir la figure 2-2), 

Exempl e 

<RDC> 

<?play "QuicktimeVR" "rdc.mov" ?> 

Rez de chaussee au meme niveau que la rue, vaste et bien eclaire. 
<cuisine> 

Evier inox. Mobllier encastre. 
</cu1sine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 
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<sejour> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 
<bureau> 

Bibliotheque encastree. 
</bureau> 
<garage/> 

<!-- pas de donnees disponibles sur le garage --> 
Dans la cour : palmier en zinc, figurant le desert 
(demontabl e) . 
</RDC> 



element 

RDC 



_ processing 
instruction 

play 
"QuickTimeVR 
"rdc.mov" 



— text — 

Rez de 
chausseeau 
meme niveau 
que la rue, 
vasteetbien 
eclaire. 




text — 

Dans la cour : 

palmier en 
zinc, figurant 

I e desert 
(demontable) 



- comment - 

pas de donnees 
disponibles sur 
le garage 



Figure 2-2 

Un nceud de type element. 



La valeur textual led'un noeud detype element est la concatenation des valeurs textuelles 
de tous ses descendants de type text (pas uniquement les enfants directs, mais seulement 
les noeuds text) pris dans I 'ordrede lecture du document. L'exemplequi suitconcerne le 
document montre ci-dessus : 
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valeur textuelle de <RDC> 

Rez de chaussee au meme niveau que la rue. vaste et bien eclaire. 
Evier inox. Mobilier encastre. 

Lavabo. Cumulus 200L. 

Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande bale vitree. 

Bibliotheque encastree. 

Dans la cour : palmier en zinc, figurant le desert 
(demontable) . 



Cette valeur textuelle comporte beaucoup de lignes blanches, et nous verrons pourquoi 
un peu plus loin. 

Nceud de type attribute 

Chaque noeud de type element possede un ensemble associe de noeuds de type attri- 
bute. Ces noeuds detype attribute sont attaches au noeud element considere par un lien 
special : I 'element est parent des noeuds attributs, mais les noeuds attributs ne sont pas 
enfants de leur parent. En d'autres termes, I 'ensemble des enfants d'un element ne 
contient pas ses attributs, mais pourtant, chaque attribut a un parent, qui est I'element 
pour lequel I'attribut est defini. Un noeud attribut n'a pas d'enfant. Si I'attribut sert a 
declarer un domaine nominal, ce n'est pas un noeud detype attribute qui est cree, mais 
un noeud detype namespace. Lafigure2-3 montreun exemplede noeud attribute. 



Figure 2-3 

Un ncEud de type 
attribute. 




a pour parent 
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Exempl e 

j <cuisine surface='12in2'> 
</cuisine> 

La valeur textuelle d'un noeud de type attribute est tout simplement la valeur de cet 
attribut. 

Noeud de type namespace 

Chaque element possedeun ensemble dedomaines nominaux utilisables (mais pasforce- 
ment utilises) : ce sont les domaines nominaux declares par cet element ou I'un de ses 
ancetres, et non redefinis entre-temps le long de la hierarchie. Un noeud de type name- 
space est cree, pour chaque element, et pour chaque domaine nominal visible. Comme 
pour un noeud de type attribute, I 'element est le parent du noeud de type namespace 
ainsi cree, mais pourtant ne le possede pas en tant qu'enfant : voir la figure 2-4, 





element 



a pour parent 



namespace 

http://www.w3c.org/xml/schemas/Basic-text.dtd 




element 

alinea 



a pour parent 




a pour parent 



namespace 

http://www.w3c.org/xml/schemas/Basic-text.dtd 



namespace 

http://www.duralex.fr/salaries/cdd.html 



Figure 2-4 

D es nceuds de type namespace. 



Exempl e 

<resuine xinlns=" http://www.w3c.org/xml/schemas/Basic-text.dtcl" > 



<jur:alinea numero="12.2.3.5" 
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xml ns : jur="http: //www.dural ex.f r/sal aries/cdd . html "> 

<texte> 

<al inea> 

<al inea> 
<texte> 
</Our:al inea> 

</resunie> 

La valeur textuelle d'un noeud de type namespace est tout simplement la valeur de ce 
domaine nominal. 



Nceud de type processing-instruction 

Un noeud de type processi ng-i nstructi on est cree pour chaque instruction de traite- 
ment, sauf si elle intervient a I'interieur del a partie DTD du document. Un noeud detype 
processing-instruction n'a pas d'enfant : voir la figure 2-5. 

Exemple 

<passacaille> 

<?play audio armide.avi?> 

</passacaille> 



Figure 2-5 

Un na?ud detype 

processing 

instruction. 



^element 

^ passacaille 



processing 
instruction 



play audio armide.avi 



La valeur textuelle d'un noeud de type processing-instruction est la chaine de carac- 
teres comprise entre le nom de I'instruction (exclu) et le ?> final (exclu). Dans notre 

exemple, ce Serait done audio armide.avi. 

Nceud de type comment 

Un noeud detype comment est cree pour chaque commentai re, sauf s'il intervient a I'inte- 
rieur de la partie DTD du document. Un noeud detype comment n'a pas d'enfant : voir la 
figure 2-6. 
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Exempl e 

<passacaille> 
<!-- debut de 



a passacaille --> 



</passacai 1 1 e> 



Figure 2-6 element 

Unn^uddetype passacaille 
comment. 

comment 

debut de la passacaille 



La valeur textual led'un noeud detype comment est la chalne de caracteres comprise entre 
le debut et la fin du commentaire ( <!-- et -->exclus) . Dans notre exemple, ce serait 

done debut de la passacaille, 



Noeud de type text 

Chaque noeud detype element peut avoir desnoeudsenfants detype text. II n'y ajamais 
deux noeuds de type text cote a c6te parmi les enfants du noeud ei ement parent, car un 
noeud text esttoujourscree d'un seul tenant, detellesorteque le nombre total de noeuds 
text enfants du noeud element considere soit minimal, et que la taille de chacun d'eux 
soit maximal. Un noeud detype text n'a pas d'enfant : voir la figure 2-7. 

Exempl e 

<xxx> 

blabla 

<yyy> ■ ■ ■ </yyy> 
suite du blabla 
</xxx> 



Figure 2-7 

Deux na?ud5 de type 
text. 



element 

XXX 
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En general, la representation arborescented'un documentXM L necontenantpasdetexte 
apparent comporte tout de meme des noeuds text (11 suffit pour cela que le document 
XML soit indente pour en ameliorer la lisibilite) : 

<xxx> 

<yyy> 

<zzz a="12'7> 

</yyy> 

</xxx> 

Dans ce document X M L, il y a dessautsdelignes(puisqu'il y a manifestementplusieurs 
lignes) et des tabulations ou des espaces (puisque les lignes sont manifestement inden- 
tees). Ces caracteres (saut de ligne, espace, tabulation) sont connus sous I'appellation 
generique d'espaces blancs (white space en anglais) ; ces espaces blancs etant des carac- 
teres, lis donnent, comme les autres, naissance a des noeuds text (voir figure 2-8). 



Figure 2-8 

Des nauds de type 
text qu 'on 
n'attendait pas. 



element 

XXX 




a pour parent 



attribute 

a="12" 



Dans la figure 2-7, le premier noeud text contient done plus que caracteres qu'il n'y 
paralt : sautde ligne, tabulation, blabia, saut de ligne, tabulation. C'est pour la meme rai- 
son que la valeurtextuellede I 'element <rdc> montre a la section N^ud de type element, 
page 31 est parseme de lignes blanches. 

L a valeur textuelle d'un noeud de type text est tout simplement la valeur de ce texte. 
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Exemple d'arbre XML d'un document 

On prend ici comme exemple un document XM L de description d'une maison (dans le 
styleagenceimmobiliere), eton montrel'arbreXM L correspondant, tel qu'il sera mani- 
pule par X Path (voir figure 2-9) : 

Maison .xml 

<maison> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface='15m2'> 

Bibliotheque encastree. 
</bureau> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

Palmier en zinc figurant le desert 
</terrasse> 

<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='r> 
Lambri s . 

</al cove> 
</chambre> 

<chambre surface='18m2'> 

Lambris. 
</chambre> 

<sal leDeBalns surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 



Note 

Sur la figure 2-9, les espaces blancs ne sont pas mis en evidence, et les nceuds texte ne contenant que des 
espaces blancs ne sont pas montres, afin de ne pas trop compliquer la figure. Ces nceuds « a blanc » sont 
en general inutilises et souvent Inoffenslfs ; en deuxieme lecture, on pourra se reporter a I'lnstruction 
<xsi : strip-space) pour une analyse de ce probleme. 
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XPath, un langage d'expressions 

Note 

Cette section peut etre ignoree en premiere lecture 



Xpath est un langage d'expressions. Cela signifie que dans ce langage, a part I'expres- 
sion, 11 n'existe aucune autre construction syntaxique. Sans etre complique, le langage 
n'est pourtant pas d'une simplicite extreme, et 11 peut arriver, de temps a autre, que I'on 
soitderoute par unesubtilite inattendue. 

En X Path, on peut manipuler quatre types d'objets : les ensembles de noeuds (type node- 
set, c'est-a-di re une col lection non ordonnee sans repetition de noeuds d'arbreXM L), les 
booleens (type boolean), les nombres reels (type number), les chaines de caracteres (type 
string). Les types boolean, number et string sont cequ'on appelle des types simples. 

Par ailleurs, on dispose d'operateurs, mais il n'y a pas plethore : dans le genre minima- 
liste, c'estassez reussi. 

Enfin, on dispose de fonctions predefinies, qui renvoi ent des valeurs de I'un des quatre 
types possibles, de variables, qui apparaissentsous la forme d'un nom precede d'un dol- 
lar (ex : $prixAuKilo), et de valeurs litteraleS (ex : true, 12, 12.5, 'Bonjour Madame, 

6ta-t-ii son ctiapeau. '). II n'y a pas de valeurs litterales detype node-set. 

Avec tout cela, on peut former des expressions. M ais il n'est pas tres simple d'etudier 
comment, parce qu'il n'est pas evident de trouver par quel bout prendre la chose ; une 
lecture fidele du standard X Path aurait vite fait de nous entrainer dans des contrees etran- 
ges ou I'on definit des choses aussi incroyables qu'un test d'inferiorite entre un node-set 
et un booleen. 



Note 

II ne faudrait pas croire pour autant que le standard XPath est un document loufoque : si ces comparaisons 
extraordinaires sont possibles, c'est parce qu'll existe des fonctions de conversions et des algorithmes d'interpre- 
tation des expressions mixtes, et que ces fonctions et algorithmes couvrent tous les cas utiles ; et de fait, dans la 
pratique, il peut etre Indispensable de pouvoir convertir un node-set en booleen. A partir de la, plus rien ne peut 
I'empecher de le comparer a un autre booleen, meme si ce n'est pas forcement tres utile. 



Pour eviterdetomber dans ce genre detrou noir, nousallonsfaireun peu de slalom dans 
la grammai re XPath : nous verrons d'abord des expressions ne comportant aucun argu- 
ment de type node-set, puis des expressions ne comportant que des arguments de type 
node- set, puis nousevoquerons les expressions mixtes, en evitantde nous perdre dans les 
details. En annexe, on trouvera la description des fonctions deconversions a utiliser. 

Enfin, et c'est la qu'on voulait en venir, nous arriverons au type principal d'expression 
XPath, lechemin de localisation, qui nous occupera jusqu'a la fin dece chapitre. 
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Note 

En premiere lecture, il n'est pas utile de suivre lineairement les prochaines sections. Vous pouvez sauter directe- 
ment a la section Expressions mixtes, page 45, dans lequel vous pourrez vous contenter de lire ce qui concerne 
la comparaison d'un node-set et d'un booleen, ainsi que celle d'un node-set et d'une string. Ensuite, vous pour- 
rez reprendre une lecture normale a partir de la section Principes de la construction d'un chemin de localisation, 
page 47. 

Les sections sautees pourront etre consultees ulterieurement, en cas de besoin, ou a titre de curiosite, pour 
completer vos idees et vos connalssances sur les expressions XPath. 



Expressions sans argument de type node-set 

Expressions numeriques 

Ce sont des expressions qui manipulent des nombres, c'est-a-dire des objets de type 
number, Ces nombres sont des nombres fractionnaires en double precision, conformes 
a la norme IEEE 754. Cette norme definit entre autres une valeur NaN (Not a Number) 
que I'on obtient par exemple dans la division de 0 par 0, mais aussi un infini positif 

(infinity) et un Infini negatif (-infinity). 

Les nombres peuvent etre compares par les operateurs = <= >= != qui ontleur significa- 
tion habituelle. 

Pour les calculs, on dispose de I'operateur « moins» unaire (-5.8, par exemple) et des 
cinq operateurs binaires classiques : -I- - * div mod (addition, soustraction, multiplica- 
tion, division, reste de la division entiere). Ajoutons a cela trois (excusez du peu) fonc- 
tions mathematiques predefinies : floor (plus grand entier inferieur), ceiling (plus petit 
entier superieur) et round (plus proche entier). 

1 1 n'y a rien d'autre, meme pas de fonctlon puissance ou raclne carree. 

Exemple d'expressions numeriques 

$b * 100 + $d - 4800 + floor($m div 10) 

$J + 31741 - ($J mod 7)) mod 146097 mod 36524 mod 1461 

(($d4 - $L) mod 365) + $L 

Expressions a base de chaines de caracteres 

Les valeurs lltterales de chaines de caracteres sont des sequences de caracteres entre 
apostrophes doubles (") ou entre apostrophes simples (■), comme on veut. 

On peut tester I 'egalitede deux chaines (operateurs = ou !=) malson nepeutpaslesclas- 
ser : les operateurs < ou > provoquent une conversion de leurs arguments en nombres. La 
seule maniere, a la rigueur envisageable, de classer deux chaines dans I'ordre alphanu- 
merique, seraitd'uti User I 'instruction detri proprea XSLT. 

On dispose de quelques fonctlons predefinies de traitement de chaines : 

• string-i ength, pour renvoyer le nombre de caracteres de la chaine ; 

• concat, pour concatener deux chaines en une seule (c'est-a-dire les mettre bout a bout) ; 
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• normal ize-space, pour supprimer tous les espaces blancs en tete, tous les espaces 
blancs en fin, et remplacer toute autre sequence interne d'espaces blancs par un seul 
espace ; 

• translate, pour remplacer certains caracteres par d'autres ; 

• substring, pour extraire une sous-chalne ; 

• contains, pour tester la presence d'une sous-chaine dans une chalne ; 

• starts-with, pour tester la presence d'une sous-chalneau debut d'une chaine; 

• substring-after, pour rechercher une sous-chaine et extraire la sous-chaine situee 
apres ; 

• substring-before, pour rechercher une sous-chaine et extraire la sous-chaine situee 
avant, 

Lafonction ends-with n'exlste pas. 
Expressions booleennes 

II n'y a pas de valeurs litterales commetrue ou false pour representer les deux booleens 
possibles. Ces deux valeurs sont donnees par deux fonctions sans argument : true( ) et 

falseO. 

Pour operer des calculs booleens, on ne dispose que de deux operateurs, or et and, et 
d'une fonction predefinie, note ), qui renvoie la negation de son argument, 

Exemple d' expression booleenne 

(SsomiTie < 3000) and ($devise = 'Franc') and ($fin1 or not( Strouve)) 

Les operateurs de comparalson < ><=>== != sont utilisables avec les booleens. Les 
operateurs = et != ont le sens habituel ; les operateurs d'inegalite provoquent une 
conversion prealable des booleens en nombres, avec la convention true donne 1 et false 
donne 0 ; ensuite on compare les nombres. N otez que si $a et $b sont deux booleens, $a 
<= $b signifie "$a impiique $b" (en effet, "$a impiique $b" n'est faux que si $aestvrai 
et $b est faux, ce qui est compatible avec une comparalson des nombres 0 et 1, d'apres la 
convention indiquee). 

Expressions avec arguments de type node-set 

Un node-set, nous I'avons deja dit, est un ensemble de noeuds provenant d'une source 
X M L , et plus precisement de la representation sous forme d'arbre X M L de cette source. 
Qu'un element appartienne a un node-set n'implique pas que sa descendance en fasse 
necessairement partie: par exemple, on peut tres bien avoir un node-set ne contenant 
qu'un seul element, a savoir I 'element racine du document, sans que pour autant, tout le 
document se retrouve dans le node-set. 

Un node-set est un ensemble au sens mathematique du terme: une collection non 
ordonnee de noeuds d'arbreX M L, sansdoublon. 
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II n'y a qu'un seul operateur ensembliste : I'operateur •■ | " (la barre vertical e), qui repre- 
sente I'union ensembliste. II esttoutefois possible d'ecrire une expression, pas tres com- 
pliquee en termes de nombre de caracteres, mais tres difficile a imaginer quand on ne 
connait pas la solution, qui donne intersection de deux node-sets. 

Note 

C'est d'ailleurs si peu evident a trouver que ies concepteurs du standard XPath etaient loin d'imaginer que 
c'etait faisabie lorsque ie standard est paru dans sa version definitive, en 1 999. En fait, il a fallu attendre I'annee 
2000 pour que quelqu'un (Michael Kay, en I'occurrence) decouvre cette fameuse expression, que voici : 
$p[count (. |$q) = coLint($q)], qui donne I'intersection des deux node-sets $p et $q. II n'est pas possible 
d'expliquer des maintenant pourquoi Ie resultat obtenu est Ie bon, car il faut attendre d'avoir vu la notion de predi- 
cat, qui est ici utilisee, ainsi que celle de noeud contexte (Ie point, juste avant la barre verticale). 

II n'y a pas non plusd'operateur ou defonction predefinie permettant de tester I' apparte- 
nance d'un noeud a un node-set (si non 11 aurait ete trivial de construire une expression 
donnant I'intersection), ou I'inclusion d'un node-set dans un autre. Par contre, on a une 
fonction predefinie, count ( ), qui renvoiele nombre d'elementsdu node-set donne, cequi 
permet (entre autres) de tester si un node-set est vide. 

Les choses amusantes arrivent maintenant. II est possible, grace aux operateurs = et !=, 
de comparer des node-sets. Les regies de comparaison sont a premiere vue assez cu- 
rieuses, et en tout cas, ont des consequences assez etonnantes, comme par exempi e eel I e- 
ci : si $p est un node-set, alors $p = $p n'est pas une expression touj ours vraie. 

Remarque 

Avant de voir ceci plus en detail, demandons-nous pourquoi aller chercher des regies diaboliques qui parsement 
la route de chausse-trappes, au lieu de mettre en place de regies classiques qui seraient intuitivement evi- 
dentes ? A nouveau, il ne faut pas imaginer que Ie standard XPath est un document loufoque, pratiquant 
I'humour par I'absurde. En fait ces regies sont bizarres quand on les examine en dehors de leur contexte, et 
qu'on les replace dans Ie contexte general (mathematique) de manipulation d'ensembles. Mais ce n'est pas 
dans ce contexte-la que ces expressions sont employees ; ces regies sont faites pour ecrire des predicats de 
fagon concise. II est encore trop tot pour expliquer exactement ce qu'est un predicat, mais disons en gros qu'un 
predicat est une expression booleenne qui permet de filtrer un node-set pour eliminer les indesirables, a savoir 
les noeuds qui ne verifient pas Ie predicat. C'est done a la lumiere de la facilite d'ecriture de predicats qu'il faut 
eclairer les regies de comparaison de node-set, et non a la lumiere des mathematiques standard. En cherchant 
a optimiser au mieux I'ecriture de certains types de predicats qui reviennent souvent dans la pratique, on arrive 
a des choses qui peuvent donner froid dans Ie dos au premier abord, mais qui finalement se revelent tres effi- 
caces a I'usage, quand on ecrit des predicats. Le seul probleme est que les comparaisons de node-sets peuvent 
intervenir ailleurs que dans des predicats, par exemple dans des tests, avec I'instruction XSLT <xsi nf . . .>. 
C'est la qu'on peut deraper, parce qu'on n'est plus dans le domaine privilegie des predicats, et que Ton doit etre 
conscient des pieges que constituent ces regies vis-a-vis de la logique habituelle. 



Comparaison de deux node-sets avec I'operateur = 

Si $p et $q sont deux node-sets, alors $p = $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un noeud ni et dans $q un noeud n2 qui ont meme 
valeurtextuelle. 
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Cette definition repose sur la valeur textuelle d'un noeud, qui a ete definie a la section 
M odele arborescent d'un documentXML vu par XPath, page 30. 

On voit tout de suite qu'il faut pouvoir trouver au moins un noeud dans chacun des node- 
sets pour que I'egalite ait une chance d'etre vraie ; il en resulte immediatement que deux 
node-sets vi des ne sont pas egaux, et meme pi re, que $p = $p est faux si $p est vide, 

Un autre point a prendre en compte, est que la valeur textuelle d'un noeud ne reflete peut- 
etre pas total ement toutes les proprietes visibles de ce noeud. 

Par exemple, SUppOSOnS que $p COntienne I'element <animal hauteur="3m">gi raf e</ani - 
mal>, et $q I'element <animal hauteur="5m">gi raf e</ani mal >; alors I'egalite $p = $q 

est vraie. En effet, les attributs nefont pas partiede la valeur textuelle d'un element : les 
deux elements ci-dessus ont done meme valeur textuelle, ce qui suffit a donner I'egalite. 

Comparaison de deux node-sets avec I'operateur != 

Si $p et $q sont deux node-sets, alors $p != $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un noeud ni et dans $q un noeud n2 qui ont des 
valeurs textuelles differentes. 

D'apres les deux definitions que I'onvient devoir, 11 est immediat que: not( $p = $q ) 
et ( $p != $q ) sont deux expressions differentes, qui ne donnent pas en general le 
meme resultat. II en est de meme avec note $p != $q ) et ( $p = $q ) . 

L'expression note $p = $q ) est vraie quand les deux node-sets ont des valeurs tex- 
tuelles toutes differentes deux a deux. De meme, I'expression note $p != $q )estvraie 
quand les deux node-sets ont des valeurs textuelles toutes identiques deux a deux. 

Notez bien encore une fois que les comparaisons reposent sur des comparaisons de 
valeurs textuelles ; il n'est pas question ici d'identite : revoyez ci-dessus I'exemple de la 
girafe, qui montre bien les limites deces comparaisons. 

Appartenance et test d'inclusion 

Tester si deux node-sets sont constitues des memes noeuds est beaucoup plus subtil ; c'est 
le meme probleme, en gros, que de tester si un noeud donne appartient ou non a un node- 
set. Pour cela I'idee de base est d'ajouter au node-set le noeud en question ; si cela ne 
change pas le cardinal du node-set, c'est que le noeud s'y trouvait deja (puisqu'un node- 
set est un ensemble, et qu'a ce titre, il nesauraity avoir des doublons). II faut done se 
debrouiller pour former un node-set (disons $p) ne contenant que le noeud a tester; 
pour savoir si ce noeud appartient a un autre node-set $q, il suffit de tester I'expression 

countC $p I $q ) = countC $q ). 
Note 

C'est cette idee qui a mis du temps a voir le jour. 

Detail amusant, on peut voir a I'adresse http://dpawson.co.uk/xsl/sect2/muench.html, que Michael Kay en a eu 
la revelation dans son bain. 
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Plus generalement, ['expression countc $p | $q ) = countc $q ) est vraie si et seule- 
ment si le node-set $p est inclus dans $q. 

Dans la meme veine, on volt immediatement que les deux node-sets $p et $q sont iden- 
tiques (egaux au sens mathematique du terme) si et seulement si : 

I (countc $p I $q ) = countC $q )) and (countC $p | $q ) = count( $p )) 

Expressions mixtes 

Les expressions mixtes sont celles ou un argument est un node-set, et I'autre un type 
simple (Boolean, String, Number). 

• node-set = Boolean ou node-set i = Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si et seulement si I e node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set = String ou node-set i = String 

L'egalite (respect, inegalite) est vraie si et seulement si I e node-set contient au moins 
un noeud dont la valeur textuelleestegale a (respect, differente de) la String donnee. 

• node-set = Number ou node-set != Number 

L'egalite (respect, inegalite) est vraie si et seulement si le node-set contient au moins 
un noeud dont la valeur textuel I e, convertieen nombre, estegaleau (respect, differente 
du) Number donne. 

• node-set < > <= >= Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si et seulement si le node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set < > <= >= Number 

La comparaison est vraie si et seulement si le node-set contient au moins un noeud dont 
la valeur textuel I e peutetre convertieen un nombre pour lequel la comparaison avec le 
Number donne est vraie. 

• node-set < > <= >= String 

La comparaison est vraie si et seulement si le node-set contient au moins un noeud dont 
la valeur textuel I e peutetre convertieen un nombre pour lequel la comparaison avec la 
String donnee, converti eel I eaussi avec succesen nombre, est vraie. Danstous les cas, 
si jamais la String donnee ne peut pas etre correctement convertie en nombre, la 
comparaison estfausse. 

C'est ici que nous trouvons ces fameuses expressions bizarres, qui consistent (par ex- 
emple) a tester la relation d'inferiorite ou de superiorite entre un node-set et un booleen, 
Comme nous I'avons dit, la motivation essentielle de ce genre de conversion est de 
pouvoir ecrire de fa^on concise certains predicats frequents dans la pratique. 
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II n'est pas possible de montrer cela dans le detail des maintenant, mais on peuttout de 
meme donner une idee de la chose. Imaginons par exemple un document X M L formant 
un recueil de descriptions de maisons comme celle que nous avons vue a la section 
Exemple d'arbre XML d'un document, page 38. Supposons de plus que nous ayons 
forme un node-set $ies-rdc qui contienttous les <rdc> detoutes les <maison>. 

On peut alors filtrer le node-set $ies-rdc par le predicat [ garage ] , comme ceci : 

P $les-rdc[ garage ] 

Celadonneun nouveau node-set qui necomportequedes rez-de-chausseeavec au moins 
un garage. M ais si cela donne cela, c'est parce qu'arrive a une certaine etape de inter- 
pretation de cette expression, I'interpreteur XPath reclame une expression booleenne 
applicable a chaque element <RDC> candidat a faire partiedu nouveau node-set; si cette 
expression booleenne est vraie, le candidat est accepte, sinon 11 estrejete. Or, acestade, 
11 se trouve que I 'expression garage est interpretee comme une valeur de type node-set : 
c'est la qu'intervient cette fameuse conversion de node-set en booleen, grace a laquelle 
I'interpreteur XPath va obtenir ['expression booleenne qu'il attend. 

M ais void quelqu'un qui voudrait voir toutes les maisons qui ont une terrasse en etage 
avec un palmier en zinc figurant le desert. Rien de plus facile : 

I $les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

La encore, si cela fonctionne, c'est parce qu'au moment ou I'interpreteur XPath reclame 

son expression booleenne, on lui fOUrnit terrasse = "Palmier en zinc figurant le 

desert". D 'apres ce que nous avons vu, cette expression estvraies'il I'on peuttrouverau 

moins une <terrasse> dont la valeur textuelle est egale a "Palmier en zinc figurant 
le desert". 

C'est done pour opti miser la facilite d'ecriture de tels predicats que ces regies bizarres de 
conversion etdecomparaison ontete misesen place. C'estvrai que I 'on obtient alors des 
predicats assez concis, et qui se lisent assez bien ; mais des que I'on quitte le domaine 
des predicats, le cote bizarre de ces comparaisons reprend alors le dessus. 

II fautassumer. 
Conclusion 

Nous arrivons maintenant aux portes du temple XPath. Comme nous I'avons deja dit, 
XPath est essentiellement un langage d'expressions pour construire des node-sets 
contenant des noeuds preleves dans I 'arbre XML document source : de telles expressions 
s'appellent des chemins de localisation (location path), et ce sont elles que nous allons 
maintenant etudier. 



Principes de la construction d'un chemin de localisation 

Chapitre 2 

Principes de la construction d'un chemin de localisation 

Note 

A lire des la premiere lecture. 



Nceud contexte 

Etant donne un certain noeud (appele n^ud contexte) de I'arbre XML d'un document 
source, un location patli (ou cliemin de localisation) permet de designer ses vol sins plus 
ou moins proches ou lointains, dans toutes les directions (ascendants, descendants, 
freres, cousins, etc.). 

Le nceud contexte, en tant que point de depart de la navigation dans I'arbre XM L d'un 
document, est unedes notions fondamentalesdu langageXPath, que I 'on retrouvera sans 
cessedans la suite. 

Chemin de localisation 

Un chemin de localisation a la forme suivante(exprimee en utilisant la notation des DTD) : 

LocationPath 

I LocationPath = "/"?, LocationStep, ( "/", LocationStep )* 

Un chemin de localisation est done une suite d'etapes de localisation (location step) 
separees par des v". Le "/" initial indique un chemin absolu ; en son absence, on a un 
chemin relatif. 

Le nceud contexte est indispensable pour I'evaluation d'un chemin de localisation rela- 
tif ; pour un chemin absolu, le point de depart est la racine de I'arbre XM L du document 
(en cesens, on peutdirequ'un « chemin absolu » est relatif a la racine, alorsqu'un « che- 
min relatif » est relatif au nceud contexte). 

Evaluation d'un chemin de localisation 

Lorsqu'on evalue un chemin de localisation, on obtient un node-set, c'est-a-dire une col- 
lection de nceuds non ordonnee et sans repetition. On dit que le chemin de localisation 
selectionne un ensemble de nceuds. Ce processus de production d'un ensemble de nceuds 
repose sur la repetition d'etapes de localisation, chacune de ces etapes consistant essen- 
tiellement en un processus d'elimination : on part d'un ensemble initial de nceuds, que 
I 'on passe au crible uneou plusieurs fois (souvent uneseulefois), avec des cribles diffe- 
rents. 

Ce qui reste apres application de cette succession d'etapes, est I'ensemble de nceuds 
Selectionne par le chemin de localisation. 

I I faut maintenant voir chacun des constituants d'une etape de localisation. 
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Note 

A lire des la premiere lecture. 

Une etape de localisation a la forme suivante (notation DTD) : 

LocationStep 

LocationStep = Axis, NodeTest, Predicate* 

Chaque etape de localisation se compose done : 

• D'un axe de localisation, qui produit I'ensemble initial de noeuds (a condition de 
connaitre le noeud contexte). L e mot axe vient de ce que cet ensemble initial est consti- 
tue a partir de noeuds choisis selon un critere evoquant une direction ou un axe de 
deplacement dans I 'arbre (parents, enfants, freres, etc.). 

• D'un premier crible (NodeTest, ou determinant ) permettantd'eli miner de I'ensemble 
initial de noeuds tous ceux qui ne repondent pas au critere indique par le NodeTest 
(qui porte sur la nature des noeuds a conserver). Ce premier crible permet par exemple 
dedirequ'on ne veut garder que les <piedDePage>, ou que les <figure>, etc. 

• Eventuellement de cribles supplemental res, appeles predicats, permettant de dire par 
exemple qu'on ne veut pas garder toutes les <figure>, mais seulement celles qui ont 
un attribut 'type' egal a 'gif . 

Exemple : 

LocationStep 

child: :figu re [attribute: :type='gif '] 

Cetteetapede localisation se decompose ainsi : 

• child estl'axedelocalisation ; 11 fournit I'ensemble de depart, constitue ici de tousles 
noeuds enfants directs du noeud contexte. 

• figure est le determinant (N odeTest) ; 11 permet d'eliminerde cet ensemble de depart 
tous les noeuds qui ne sont pas des <f i gure> . 

• [attribute: :type='gif'] est le premier (et I'unique) predicat, qui joue le role de 
deuxieme crible, eliminant tous les noeuds <figure> n'ayant pas un attribut type egal 

a gif. 

Le principe de construction d'un node-set par une etape de localisation est done assez 
simple : on part d'un node-set initial fourni par un axe de localisation, qui est d'abord 
filtre par un determinant, puis par des predicats. 

Nous allons done voir maintenant plus en detail chacun deces constituants. 
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Axes de localisation 

Mentionner un axe de localisation dans une etape de localisation permet d'obtenir un 
node-set initial, qui sera ensuite progressivement elague sous I'action du determinant 
(Node Test) puis des predi cats. 

L'idee est done qu'un axe de localisation represente une premiere approximation de ce 
que I'on veut, en se basant sur la notion de voisinage du noeud contexte : les enfants, les 
freres, les ascendants, etc. : on choisit ce qui se rapproche le plus du node-set souhaite, 
quitte ensuite a filtrer les noeuds en trop. L'approximation doit toujours se faire par exces, 
puisqu'il est possible de filtrer, mais pas d'ajouter. 

Etant donne un noeud-contexte, un axe est done un ensemble de noeuds, partageant une 
propriete commune vis-a-vis du noeud contexte. 

Les treize axes de localisation 

Le standard X Path definit treize axes de localisation. Les onze premiers sont construits a 
parti r du noeud contexte sur la base de la relation parent-enfant, ce qui donne un arbre 
genealogique presque identique a I'arbreXM L du document source : il ne manque que 
les noeuds detype attribute et namespace. Precisement, les deux derniers axes corres- 
pondent aux attributs et domaines nominaux du noeud contexte, mais ils sont un peu a 
part, puisqu'il n'y a pas de relation parent-enfant complete entreun noeud et ses attri buts 
ou domaines nominaux (revoir a ce sujet les sections N^ud de type attribute, page 33 et 
Nceud de type namespace, page 34). 

Void la listedeces 13 axes : 

• child 

contientles noeuds enfants (directs) du noeud contexte. Necontientjamaisde noeud de 
type attri but ou domai ne nomi nal . 

• descendant 

contient toute la descendance (enfants, petits-enfants, ...) du noeud contexte. Ne 
contientjamais de noeud detype attri but ou domaine nominal. 

• parent 

contient le parent du noeud contexte. Existe pour tout noeud contexte (meme de type 

attribute OU namespace), Sauf pOUr la racine (root). 

• ancestor 

contient les ascendants (parent, grand-parent, ...) du noeud contexte. Contient toujours 
la racine (meme si le noeud contexte est de type attribute ou namespace), sauf si le 
noeud contexte est la racine. 

• self 

contient le noeud contexte et seulement le noeud contexte. 

• following-sibling 

contient les freres suivants (dans I'ordre de lecture du document) du noeud contexte. 
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Si lenoeud contexteestun noeud de type attri but ou domaine nominal, I'axefoiiowing- 

sibl ing eSt vide. 

• preceding-sibling 

contient lesfreres precedents (dans I 'ordrede lecture du document) du noeud contexte. 
Si le noeud contexte est un noeud de type attribut ou domaine nominal, I'axe 

preceding-sibling est vide. 

• following 

contient tous les noeuds qui suivent le noeud contexte dans I'ordre de lecture du docu- 
ment, en excluant d'une part la propre descendance du noeud contexte, et d'autre part 
les noeuds de type attribut ou domaine nominal. 

• preceding 

contient tous les noeuds qui precedent le noeud contexte dans I'ordre du document, en 
excluant d'une part la propre ascendance du noeud contexte, et d'autre part les noeuds 
detype attribut ou domaine nominal. 

• descendant-or-self 

contient le noeud contexte et tous ses descendants (commeson nom I'indique). 

• ancestor-or-self 

contient le noeud contexte et tous ses ascendants (comme son nom I'indique). En 
consequence, contient touj ours la racine. 

• attribute 

contient les attributs du noeud contexte si le noeud contexte est un element ; est vide 
dans le cas contraire. 

• namespace 

contient les domaines nominaux du noeud contexte si le noeud contexte est un element ; 
est vide dans le cas contraire. 

Representation graphique 

On peut representer graphiquement (voir figure 2-10) les ensembles de noeuds que 
forment les axes (les axes attri bute et namespace ne sont pas montres, et I'un des noeuds 
e I ement est pris arbitral rement comme noeud contexte). 

Note 

La figure 2-10 est tres largement inspiree d'un schema extrait de « Practical Transformation Using XSLT and 
XPatti », un support de cours et un livre sans nom d'auteur (copyrigfit 1998-2001 Crane Softwrigfits Ltd.) dont un 
extrait est disponible sur www.cranesoftwrights.com/training/. 

On volt sur la figure 2-10 que I'axe ctii i d d'un element peut contenir des noeuds de type 

el ement, maiS aUSSi detype processing instruction, text, OU comment. A fin de pOUVOir 

trier, on dispose de possibilitesde tests adequats (voir Determinant (Node Test), page 54). 



Etape de localisation 

Chapitre 2 



0 




descendant-or-self 



O f ® • o 

noeud processing noeud comment noeudtext nceud element 

contexte instruction 

Figure 2-10 

Representation des axes de localisation en tant qu 'ensembles. 

D 'autre part, les numeros des noeuds sur cette figure correspondent a I 'ordre d'apparition 
de leur balise ouvrante, lors de la lecture sequentielle du document X M L correspondant, 
qui ressembledonc aceci (I e noeud 9 est le noeud contexte) : 

<i> 

<2> 

<3/> 
<4/> 
<5> 

<6> 

<7/> 

</6> 
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<8/> 
<9> 

<? processing-instruction ?> 
<10> 

<ll/> 
<12/> 
</10> 

<!-- commentaire --> 
<13> 

<14/> 

<15/> 
<13/> 
un texte 

</9> 

<16/> 

<17> 

<18/> 
</17> 

</5> 

<19/> 

<20/> 

</2> 

</l> 

Remarque 

Sur la figure 2-10, on voit le node-set sei f , qui ne comporte qu'un seul element. Pourtant, cet element possede 
une descendance assez nombreuse : il est important de realiser qu'un node-set peut tres bien contenir un 
element sans pour autant contenir les enfants ou la descendance de cet element. Mais ce n'est pas interdit non 
plus : voir par exemple le node-set descendant-or-seif. 

Les 3XeS parent, ancestor, ancestor-or-sel f , preceding, et preceding-sibling ne 

contiennent que des noeuds situes avant (par rapport au noeud contexte) dans I'ordre de 
lecture du document : on les nomme axes retrogrades. 

Tous les autres axes (y compris les axes attri bute et namespace) ne contiennent que des 
noeuds situes apres (par rapport au noeud contexte) dans I'ordre de lecture du document : 
on les nomme axes directs. 

L'ordre de lecture du document, pour les attri buts et les domaines nominaux, est un peu 
arbitral re par certains cotes. La regie est celle-ci : les attri buts et domaines nominaux 
viennent apres leur element parent, et avant les enfants de ce parent (ce qui est somme 
toute parfaitement logique, et correspond effectivement a I'ordre de lecture du docu- 
ment). Cequi est arbitral re, c'estque les domaines nominaux viennent avant les attri buts 
(c'est une simple convention). M aisaucun ordrede lecture de document n'est defini pour 
classer les attributs entre eux, ni les domaines nominaux entre eux, car I'ordre dans 
lequel lis apparaissent n'est pas cense etre signifiant (cette propriety est imposee par 
XML). 
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Indices de proximite 

On definit aussi une numerotation des noeuds relative a un axe, dont les numeros, appeles 
indices de proximite, commencenttoujours a 1. 

Pour un axe direct (par. ex. child ), les indices de proximite augmentent quand on s'e- 
loigne du noeud contexte en suivant I 'ordre de lecture du document, alors que pour un axe 
retrograde (par. ex. preceding-sibling ), les indices de proximite augmentent quand on 
s'eloigne du noeud contexte dans I 'ordre inverse de lecture du document. 

A titre d'exemple, reprenons la figure 2-10 , et montrons les indices de proximites pour 

deux axes retrogrades (preceding, ancestor-or-self), et pour 2 axes directs (descen- 
dant, following). Ces indices de proximite sont montres sur la figure 2-11 (les anciens 
numeros sont rappeles en plus petit, a I'exterieur de chaque cercle). 



preceding 




2 



ancestor-or-self 



following 



19 20 



'16 



\ instruction 



processing comment 

i ncfn \rV\r\r\ • • 1 i • 
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text 



3 ) { 4 ) (7) { 8 ) 

jyii \jyi2 \/yi4 \Jlyi5 



descendant 



Figure 2-11 

Indices de proximite. 




La regie, pour un node-set intervenant dans une etape de localisation, est que les indices 
de proximite donnent I 'ordre d'enumeration. 
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Remarque 

Ces indices de proximite servent (entre autres) a fournir, quand besoin est, un ordre d'enumeration. Un node-set, 
rappelons-le, est un ensemble, et a ce titre, n'est pas ordonne. Pas ordonne, cela signifie que I'ordre d'enumera- 
tion des elements n'est pas une proprlete discrlminante lorsqu'on cherche a distinguer deux ensembles : les 
ensembles {x,y} et {y,x} sont indiscernables. 

Ceci etant, lorsqu'on enumere un node-set, par exemple pour traiter chacun de ses elements un par un, il taut 
bien choisir un premier, un deuxieme, etc. jusqu'a un dernier. Done meme si un node-set n'est pas ordonne, 11 est 
certainement utile, dans la pratique, d'avoir a sa disposition un algorithme d'enumeration. 

Determinant (Node Test) 

Etant donne un ensemble de noeuds fourni par un axe de localisation, le determinant est 
unefonction booleenne, qui, appliqueea un noeud decet ensemble, ditsi cenoeud doitou 
non rester dans I 'ensemble. 

L'ecriture : 

Axis: iNodeTest 

denote I 'ensemble obtenu en appli quant le determinant NodeTest a chaque element de 
I'axeAxis, 

II y a plusieurs possibilites pour un NodeTest : pour chacune d'elle, on doit specifier la 
fonction booleenne, c'est-a-dire expliquer le critere mis en oeuvre pour accepter ou reje- 
ter un noeud. Pour cela, il est necessaire d'introduire une nouvelle notion, celle de type 
principal de n^ud. 

Le type principal de noeud d'un axe de localisation, c'est le type de noeuds les plus fre- 
quemment contenus dans cet axe. 

• L'axe attribute ne contient que des noeuds de type attribute, son type principal de 

noeud est done attribute. 

• L'axe namespace ne contient que des noeuds de type namespace, son type principal de 

noeud est done namespace. 

• Les onze autres axes peuvent contenir aussi bien des noeuds de type element, que de 

type comment, OU processing-instruction, OU root, OU text. NeanmoinS, le plUS fre- 
quent, et de loin, est qu'ils contiennent des elements. Le type principal de noeud est 

done el ement. 

Ceci etant, nous allons pouvoir maintenant passer en revue les differentes formes pos- 
sibles pour un determinant (NodeTest). 

Le determinant est un nom 

Node Test = nom 



Axi s : :nom 
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L e determinant est ici un nom (d'element, d'attribut, ...). Applique a un noeud de I'axede 
localisation indique, le determinant accepte ce noeud si le type du noeud est egal au type 
principal de noeud del'axechoisi, etsi lenom du noeud coincide avec lenom constituant 
I e determinant; dans lesautrescas, le noeud estrejete, etdonc ne fait pas partiedu node- 
set resultant. 

Exemple : 

I child: :figure 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les elements de I'arbre XML considers, qui sont des enfants du noeud 
contexte, et dont le nom est figure. Tous les autres noeuds sont rejetes : 

• soit a cause de leur type qui n'est pas egal au type principal de noeud (element pour 
I'axe child) ; 

• soit a cause de leur nom qui n'est pas egal a f i gure. 

La premiere cause de rejet (portant sur le type) permet d'eliminer par exemple une 
processing-instruction qui par malchance sedenommerait elleaussi^gure. 

Le determinant est une * 

Node Test = * 

Axis::* 

Une * est un determinant qui ne filtre que le type de noeud : sont rejetes tous les noeuds 
dont letype ne correspond pas au typede noeud principal associe a I'axe indique. 

Exemple : 

I child::* 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les noeuds de type ei ement, enfants du noeud contexte. 

Autre exemple : 

I attribute::* 

Etantdonne un certain noeud contexte, cette etape de localisation selectionneun node-set 
contenant tous les noeuds de type attri bute, qui ont pour parent le noeud contexte, c'est- 
a-dire, pour parler plus simplement, tous les attri buts du noeud contexte. 

Le determinant est un descripteur de type 

Ce genre de determinant teste letype de noeud a selectionner. En cesens, la selection est 
plus fine que dans lecas precedent, avec I'etoile. Uneetoiletesteaussi le typede noeud a 
Selectionner, mais le type est impose par I'axe mentionne (c'est le type principal de 
noeud). Ici, le type est a choisir parmi quatre valeurs possibles, et le type principal 
de noeud associe a I'axede localisation mentionne n'intervient pas. 
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Node Test = type 

Axi s : :type 

Lesquatrevaleurs de types possibles (avec unevariante) sont lessuivantes : 

• textO 

text( ) est un determinant qui selectionne tout noeud de type text, et rejette tous les 
autres. 

• commentO 

commento est un determinant qui selectionne tout nceud de type comment, et rejette 
tous les autres. 

• processing-instructionO 

process i ng-i nstructi on () est un determinant qui selectionne tout noeud de type 
processing-instruction, et rejette tous les autres. 

• processing-instruction! « xxx » ) 

processing-instructionc "xxx" ) est un determinant qui Selectionne tout noeud de 
type processing-instruction dontlenom est xxx, et rejette tous les autres. 

• node() 

node( ) est un determinant qui ne rejette aucun nceud. Et comme le type principal de 
noeud n'intervient pas, (ni danscecas, ni dans les quatre autres ci-dessus), on a done le 
contenu de I'axe de localisation au grand complet. 

Exemples : 

childiitextO 

Selectionne les noeuds de type text, enfants du noeud contexte. 

chi Id: :coinment( ) 

Selectionne les noeuds de type comment, enfants du nceud contexte. 

chi 1 d: : process 1 ng -1 nstructi on ( ) 

Selectionne les noeuds de type processi ng-i nstructi on, enfants du nceud contexte. 

child: :process1ng-instruction( "play" ) 

Selectionne les noeuds de type processi ng-i nstructi on, enfants du noeud contexte, et 
dont le nom est « play ». 

I chi Id: :node( ) 

Selectionne tous les noeuds enfants du noeud contexte. On obtient done un node-set iden- 
tique a I'axe de localisation. C'est utile si on veut filtrer par d'autres criteres que ceux 
predefinis par les determinants possibles; dans ce cas, on ne filtre rien au niveau du 
determinant, mais on exprime le filtre dans le ou les predicats. 
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Predicats 

U n predicat permet d'affiner le filtrage deja effectue par le determinant sur I'axe de loca- 
lisation choisi, en eliminant de I'ensemble resultat les noeuds qui ne repondent pas a un 
certain critere, dont I 'expression constitue precisement le predicat, 

II a la forme suivante : 
Predicat 

I [ Boolean-Expression ] 

U n predicat s'applique a un ensemble de noeuds (node- set) et produit un nouveau node-set. 

Le node-set de depart peut avoir diversesorigines : 11 peutetre I e resultat du filtrage d'un 
axe de localisation par un determinant, ou encore le node-set produit par un autre predi- 
cat. II peut meme etre n'importe quel node-set reference par une variable, commedans 
I'exemple : 

I $les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

qui nous a servi a expliquer les raisons de certaines bizarreries (voir la fin de la section 
Expressions mixtes, page 45). 

Note 

Nous parlons ici a nouveau de variable ; il est vrai que nous n'avons pas encore vu la fagon de declarer et 
d'initialiser une variable ; cela viendra bien plus tard, a la section Instruction xslivariable, page 179. En effet, 
XPath ne definit pas la notion de variable, mais uniquement celle de reference a une variable, avec la notation 
$xxx. La notion de declaration et d'inltlallsatlon de variable est une notion propre a XSLT. II est done impossible, 
a ce niveau, de montrer un exemple olj une telle variable serait inltialisee. 

Comme le resultat du filtrage d'un node-set est a son tour un node- set, on peut (eventuel- 
lement) lui appliquer de nouveau un predicat, etainsi de suite : 

Predicats en cascade 

I Axis: :NodeTest[Boolean-Expression][Boolean-Express1on] ... [Boolean-Expression] 

Contexte d'evaluation d'un predicat 

Le resultat del'evaluation d'un predicat est un nouveau node-set, initialement vide, puis 
progressivement constitue en examinant un par un chaquenoeud de I 'ensemble de depart, 
et en testant s'il doit ou non faire partie du node-set resultat. 

Ce node- set de depart (appelons-le N SD ) est necessairement un sous-ensemble d'un axe 
de localisation, qui lui-meme n'existe que par rapport a un noeud contexte. On est done 
ici dans une situation ou un noeud contexte NC est defini, et ou un axe de localisation a 
ete choisi, donnant I e node-set NSD (apres un eventuel filtrage par un determinant). 

L'expression booleenneentre crochets, qui constitue I e predicat, estevaluee pourchaque 
element du node-set NSD ; cette evaluation se fait relativement a un contexte, appele 
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contexte d 'evaluation, comportant trois informations, et construit dynamiquement pour 
chaque element du node-set NSD : 

• le noeud en cours d'examen, considere d'office comme noeud contexte temporaire, si 
jamais I 'expression booleennea evaluer en a besoin d'un ; 

• lenombre total denoeuds del 'ensemble NSD (accessible par appel alafonction prede- 
finie lasto) ; 

• et I 'i ndice de proximite qui a ete affecte au noeud en cours d'examen, lors de la construc- 
tion du node-set NSD (accessible par appel a la fonction predefinie positionc )). 

Grace a ce contexte d'evaluation, tout predicat, aussi complexe soit-il, peut etre evalue. 
En void quelques exemples : 

Predicat utilisant 1'indice de proximite conserve dans le contexte d'evaluation 

child: :f1gure[ posltionO = 3 ] 

Etantdonne un certain noeud contexte NC, child: :figure selectionne un node-set NSD 
contenanttous les elements de I'arbreX M L considere, enfants dece noeud contexte NC, 
etdontlenom est figure. A partirdela, I e predicat est evalue : pour chaque element du 
node-setNSD, I'expression booleenne position( ) = sestevaluee. Lafonction predefi- 
niepositionc ) renvoielavaleur del 'indicede proximite du noeud en cours d'examen : si 
cette valeur est 3, le noeud est conserve dans le node-set resultat, sinon 11 est rejete. Au 
final, on obtient done un node-set d'au plus un element, qui est la troisieme <figure>, 
enfant du noeud contexte N C . 

Predicat utilisant le nombre total de neuds conserve dans le contexte d'evaluation 

child: :figure[ posltionO = lastO ] 

Ici, le node-set NSD est constitue de la memefagon, mais le predicat est legerement dif- 
ferent : la fonction predefinie iast( ) renvoie le nombre total d'elements de NSD ; done 
le seul element qui ne sera pas rejete par I e predicat sera I e dernier, puisque les indices de 
proximite commencent a la valeur 1. Au final, on obtient done un node-set d'au plus un 
element, qui est la derniere <figure>, enfant du noeud contexte NC. 

Predicat utilisant le naud contexte temporaire conserve dans le contexte 
d'eval uation 

child: :figure[ attribute: : type = 'gif ] 

Ici, le node-set NSD est a nouveau constitue de la memefagon, mais le predicat est com- 
pletement different. II sera analyse plus en detail un peu plus loin ; nous nous contente- 
rons pour I 'instant devoir comment intervient le noeud contexte temporaire. 

Pour chaque element du node-set NSD, 11 s'agit de comparer un node-set (le node-set 
attribute: :type) a une chaine de caracteres. La premiere chose a faire est done d'evaluer 
le node-set attribute: :type, foumi ici SOUS la forme d'une etape de localisation, basee 
sur I'axede localisation attribute. M ais I'evaluation d'un axede localisation reclame un 
noeud contexte : le contexte d'evaluation en fournit un, c'est le noeud en cours d'examen. 
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Chaque noeud examine devientdonc tour a tour « noeud contextetemporaire» dans ('eva- 
luation de I'etape de localisation attribute: :type, qui selectionne tous les attributs du 
noeud contexte temporal re dont lenom est "type". On obtientalors un node-set d'au plus 
un noeud (qu'il s'agit ensuite de comparer a une String : voir Pr«?dicat sous la forme 
[node-set], page 59). A u final, on obtient un node-set constitue detoutesles<figure> qui 
sont des enfants du noeud contexteNC, etqui ontun attribut "type" egal a "gif". 

Conversion booleenne de node-set 

Nous avons deja assez longuement evoque dans la section Expressions avec arguments 
de type node-set, page 42 les expressions mettant en jeu des node-sets pour obtenir un 
booleen. M ais 11 n'est peut-etre pas inutile d'y revenir, en se pla^ant ici dans le contexte 
precis de devaluation d'un predicat. 

II peut arriver que, dans un predicat, I'expression entre crochets [. . .] ne soit pas une 
expression booleenne. Dans ce cas, elle est convertie en expression booleenne, suivant un 
algorithmequi depend dela nature de I'expression, etqui peut paraitre, on I'a vu, un peu 
surprenant. Dans la pratique, deux cas se produisent assez souvent : I'expression entre 
crochets est un node-set, ou bien est la comparaison d'un node-set et d'une chalne de 
caracteres. 

Predicat sous la forme [node-set] 
Exemple 

I child: :figure[ attribute: :scale ] 

D'une manleregenerale, un node-set, quelqu'il soit, peut etre convert! en une expression 
booleenne: la conversion donne la valeur « vrai »si etseulementsi I e node-set n'est pas 
vide. 

M ais pour evaluer un node-set tel que attribute: : scale (ne serait-ce que pour savoir 
s'il est vide ou non), il fautun noeud contexte: ce noeud contexte est eel ui qui estfourni 
par le contexte d'evaluation (voir ci-dessus). 

II en resultequ'une etape de localisation telle que : 

I child: :figure[ attribute: :scale ] 

Selectionne les <figure>, enfants du noeud contexte courant, ayantun ensemble d' attributs 
scale non vide, c'est-a-dire (plus simplement) les <figure>, enfants du noeud contexte 
courant, ayant un attribut scale, 

Autres exemples 

child: :figure[ parent: :paragraphe ] 
child::*[ self::figure or self::iinage ] 

Le premier Selectionne les <figure> enfants du noeud contexte dont I e noeud parent est un 
<paragraphe> ; le deuxieme selectionne toutes les <figure> ou <image> enfants du 
noeud contexte. 
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Ce deuxieme exemple est assez typique de la fagon dont on peut tester le nom d'un ele- 
ment : self: :image est une etape de localisation a evaluer ; pour cela, il faut un noeud 
contexte. Or, on est dans un predicat, done le contexte d'evaluation fournit le noeud en 
cours d'examen comme noeud contexte temporaire. L'axe self selectionne done un 
node-set ne contenant que le noeud en cours d'examen ; on filtre ce node-set en ne 
conservant le noeud qu'il contient, que si son nom est image et son type est element , 
puisquec'estletype principal de noeud pour l'axe self. En fin decompte, du node-set de 
depart child: :*, qui contient tous les elements enfants du noeud contexte, sont rejetes 
tous les elements qui nesont pas des <figure> ou des <image>. 

Predicat sous la forme [node-set = String] 
Exempl e 

I child: :figure[ attribute: :scale = "0.5" ] 

Ce genre d'expression est convertie en valeur booleenne d'une fagon deja evoquee a la 
section Expressions mixtes, page 45. On peutfaireici une evaluation pas a pas, neserait- 
ce que pour se persuader que cen'est pas si trivial que cela, memesi au final I 'expression 
se lit plutot bien. 

L'expression : 

child: :figure 

produit un node-set contenant toutes les <figure> appartenant au node-set child, lui- 
meme calcule par rapport a un certain noeud contexte. Soit { fi. f2. f3, f4 } cet 
ensemble de <figure>. 

Lepredicat: attribute: :scaie = "0.5" ] s'appi i que a cet ensembi e ; c'est-a-di re 
que pour chaque element fi. fz. f3, f4 de cet ensemble, on evalue le predicat 
[ attribute: : scale = "0.5" ] pour savoir s'il est vrai ou faux. 

Pour cefaire, on prend un element, par exemple fi, eton construitle contexte d'evaluation : 

• le noeud en cours d'examen estfi, etserviraeventuellementde noeud contexte tempo- 
raire; 

• lenombred'elementsdel'ensemblede depart est 4 ; 

• I'indice de proximite de f i est 1 (en tout cas, on fait cette hypothese, qui n'est pas plus 
mauvaisequ'une autre). 

M uni du contexte d'evaluation, on peut commencer le calcul du predicat : 

• L'expression attribute: :scaie denote un ensemble de noeuds selectionne par l'axe 
de localisation attribute et filtre par un determinant scale. Le contenu de cet axe de 
localisation se determine par rapport a un noeud contexte ; le noeud contexte est ici 
fourni par le contexte d'evaluation, qui donne fi. L'axe de localisation correspond 
done a I'ensembledes noeuds de type attribute attaches a fi. Cet axe est filtre par le 
determinant scale ; on obtient done I 'ensemble A des attributs de fi ayant pour nom 
seal e (dans ce cas particulier cet ensemble a au plus un element). 
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• Le predicat a evaluer est done [ a = "o.s" ], oil A est I'ensemble precedemment 
determine. 

• Nousavons vu comment evaluer une telle expression : elleestvraiesi etseulementsi 
I'un des elements de A a unevaleurtextuelleegalea« 0.5 ». 

• Done, finalement, pour chaque element fi, f2, f3, f4, on peut savoir si le predicat 

[attribute: : scale = "0 . 5" ] eSt Vrai OU faUX. 

Ainsi I'ensemble de depart child: :figure peut etre filtre par le predicat, et le resultat 
correspond done bien a I'ensemble de toutes les <f i gure> de I'axe chi i d (relatif au noeud 
contexte courant), ayant un attribut scale egal a « 0.5 ». 

Exemples de predicats dans une etape de localisation 

I child: :paragraphe[ child: :f1gure ] 

selectionne les <paragraphe>, enfantsdu nceud contexte, qui possedent un (au moins un) 

enfant <figure>. 

I child: :chapitre[ descendant: :figure ] 

Selectionne les <chapitre>, enfants du noeud contexte, qui possedent un (au moins un) 
descendant <figure>. 

child: :paragraphe[ child::* ] 

Selectionne les <paragraphe>, enfantsdu noeud contexte, qui possedent un (au moins un) 
enfant. 

I child: :*[ child: :figure ] 

Selectionne les elements enfants du noeud contexte, qui eux-memes possedent un (au 
moins un) enfant <f i gure>. 

I child::*[ self : :chapitre or self::annexe ] 

Selectionne les elements enfants du noeud contexte qui sont des <chapitre> ou des 

<annexe>. 

' child: :paragraphe[ child: :figure[position( ) = 2] ] 

Selectionne les <paragraphe>, enfants du noeud contexte, qui possedent au moins deux 
<figure>. En effet, on filtre un node-set constitue de <paragraphe>, en se basant sur le 
fait que le node-set de ses enfants de type element et de nom fig ure contient un 
deuxieme element; s'il y a un deuxieme, c'estqu'il y a un premier, done qu'il y a au 
moins deux enfants. 

I child: :paragraphe[ child: :*[position( ) = 2][self : :figure] ] 

Selectionne les <paragraphe>, enfantsdu noeud contexte, dont I e deuxieme enfant de type 
element est une <figure>. Voyez la difference avec I'exemple precedent : ici le predicat 
[ positiono = 2 ] porte sur un node-set qui contient tous les enfants de type element 
(a cause de I'etoile qui teste uniquement le type principal de noeud), alors que dans 
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I'exemple precedent, le meme predicat filtrait un node-set ne comportant que des 
<f igure> : mais la deuxieme figure n'est pas forcement le deuxieme element, 

child: :paragraphe[ child: :node()[position() = 2][self : :figure] ] 

selectionne les <paragraphe>, enfants du nceud contexte, dont le deuxieme enfant est une 
<figure>, Voyez la difference avec I'exemple precedent : ici le predicat [ position( ) 
= 2 ] portesur un node-set qui contienttous les enfants : mais le deuxieme element n'est 
pas forcement le deuxieme enfant (en plus des elements, il peut y avoir des textes, des 
commentaires, des processing-instructions). 

child: :paragraphe[ chi Id: :node( ) [sel f : :f igure][position( ) = 2] ] 

Selectionne les <paragraphe>, enfants du nceud contexte, qui possede au moins deux 
<figure>. Voyez la difference avec I'exemple precedent : ici le predicat [ positiono 
= 2 ] portesur un node-set qui necontientquedes <figure>. Cetexemple est done equi- 
valent a : 

|child::paragraphe[ child: :f1gure[position( ) = 2] ] 
child::*[ self : :chapitre or self::annexe ][position() = lastO] 

constltue le node-set des elements enfants du nceud contexte qui sontdes <chapitre> ou 
des <annexe> ; dans ce node-set, selectionne le dernier element. Ici, I'on peut imaginer 
qu'on a un livre avec des chapitres eteventuel I ement des annexes, et que les annexes, s'il 
y en a, sont placees apres les chapitres. Cetteetapede localisation selectionne le dernier 
chapitre s'il n'y a pas d'annexe, ou la derniere annexe, s'il y en a au moins une. 

/descendant: :text()[ start-with( sel f : :node( ) , "Horaires" ) ] 

Selectionne tous les nceuds text du document qui commencent par "Horaires". start- 
with( ) est un fonction booleenne predefinie. 

child: :mohican[ positionO = lastO ] 

Selectionne le dernier des M ohicans. 
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Note 

A lire des la premiere lecture. 

Un chemln de localisation a la forme suivante : 

Chemin de localisation 

LocationPath = "/"?, LocationStep, ( "/", LocationStep )* 

Example de chetnln de localisation relatif 

child: :chapit re/child: : section 
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Exemple de chemin de localisation absolu 

I /child: ichapitre/chlld: rsection 

II y a done deux formes de chemins de localisation : les chemins de localisation absolus, 
et les chemins de localisation relatifs, suivant qu'il y a ou non un «/» initial dans 
I 'expression. 

Mais, dans tous les cas, un chemin de localisation n'est compose que d'etapesde locali- 
sation. Or une etape de localisation produit un node-set; le probleme de I'evaluation 
d'un chemin de localisation se ramifie done en deux sous problemes : d'une part savoir 
que faire de tous ces node-sets, et d'autre part, savoir comment interpreter semanti- 
quement cette cascade d'etapes de localisation. 

Evaluation d'un chemin de iocaiisation 

Evaluation d'une etape de localisation par rapport a un node-set 

Nous avons vu precedemment comment evaluer une etape de localisation par rapport a 
un noeud contexte. Nous avons vu que ce noeud contexte est indispensable pour former, 
d'apres I'axe de localisation choisi, I e node-set originel qui sera ensuitefiltre, 

Nous vi sons maintenant un peu plus haut : evaluer uneetapede localisation par rapport a 
un node-set A non vide. Si ce node-set ne contient qu'un seul element, cela ne change il 
estvrai pas grand-chose. Maiss'il en contient pi usieurs ? 

SoitA un tel node-set, contenantn noeuds. Pour evaluer leresultat d'une etape de locali- 
sation par rapport au node-set A, on evalue n fois cette etape de localisation en prenant a 
chaquefoisun noeud different du node-set A comme noeud-contexte. Ces n evaluations sont 
independantes les unes des autres, et produisent done n differents node-sets en resultat. 

Le resultat de cette evaluation est tout simplement un nouveau node-set, resultant de la 
fusion de ces n node-sets (union ensembliste de ces n node-sets). 

Une propriete agreable de cette operation est qu'elle prend en entree un node-set, et 
qu'ellefourniten sortieun nouveau node-set : il est done possible d'avoir des evaluations 
d'etapes de localisation enchalnees en cascade. 

Evaluation d'un chemin relatif 

U n chemin de localisation relatif donne un node-set qui se calcule par rapport a un noeud 
contexte donne. 

Le node-set resultat est obtenu en enchatnant, dans I'ordre ou elles apparaissent (de 
gauche a droite), les etapes de localisation qui composent le chemin, la premiere etape 
etant calculee par rapport au noeud contexte. 

Evaluation d'un chemin absolu 

Un chemin de localisation absolu se calcule comme un chemin relatif, aceci presquele 
noeud contexte de depart est impose : c'estia racinedel'arbreXM L du document source. 
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Cle pour la lecture d'un chemin de localisation 

Un chemin de localisation determine un ensemble denoeudsdontlecalcul sefaitcomme 
indique ci-dessus, eten principe, d'un strict point devuedu langage, 11 n'y a pas besoin 
d'endire plus. Neanmoins, 11 est bien evident que c'est particulierement frustrant de ne 
pouvoir lireun chemin de localisation « a la volee», pour en apprehender la semantique. 
Prenez par exemple le chemin de localisation suivant (qui n'a pourtant rien d'extraordi- 
naire) : 

parent: :chapit re/child: :section[position( ) = 3] /attribute: : niveau 

A molns d'etre entraine, 11 n'estpasevidentdedechiffreravueunetelleexpression etde 
savoir la nature exactedes noeudsselectionnesau premier coup d'oeil. II est pourtant pos- 
sible de lire « a la volee» un tel chemin de localisation, a condition deconnaitrela cle de 
lecture. 

La cle de lecture est celle-ci : quand on lit un chemin de localisation pour calculer 
I'ensembledes elements, 11 faut lire I 'expression de gauche a droite ; mais quand on le lit 
pour en apprehender qualitativement la signification, il faut le lire de droite a gauche (a 
I'envers). 

II est tout a fait possible de decrire un algorithme de lecture capable de faciliter grande- 
ment les debuts dans ce domaine. Nous allons le presenter en deux etapes, en traitant a 
partlecasdes predicats. 

Lecture d'un chemin de localisation sans predicat 

Le chemin de localisation est ecrit sous le forme d'une succession d'etapes de localisa- 
tion, comme ceci : 

etapel/etape2/etape3/. . ./etapeN 

Danscetteecriture, chaqueetapeest dela forme a: :b, ou a est un nom d'axede localisa- 
tion, et b un determinant. 

• (S) : chaque«/», danscetteecriture, seprononce« des». 

• (E) : chaqueetapeseprononce« b qui sontlesa ». 

• (I) : on commence par prononcer « Les ». 

• ( F ) : on termi ne en pronongant « du noeud contexte » ou « de I a raci ne » suivant que 
le chemin est un chemin relatif ou absolu. 

G lobalement, la phrase a prononcer pour comprendre ce que veut dire 

etapel/etape2/etape3/. . ./etapeN 

estobtenueen partant del 'etapeN, en remontant vers I'etapei, eten appliquantles regies 
(I) au debut, (F) alafin,et(E) (S) a chaqueetape, sauf la derniere : 

i (I) (E)(S) ... (E)(S) (E)(S) (E) (F) 
I etapeN etape3 etape2 etapel 
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A insi par exemple, le chemin : 

I child: :chapit re/child: : section/attribute: : niveau 

est lu en appliquant les regies : 

• ( I ) : L es 

• (E) : niveaux qui sont les attributs 

• (S) : des 

• (E) : sections qui sont les enfants 

• (S) : des 

• (E) : chapitres qui sont les enfants 

• (F) : du noeud contexte 

Ce qui donne : Les niveaux qui sont attributs de sections qui sont les enfants des cha- 
pitres qui sont les enfants du no-ud contexte . 

II peut parfois arriver qu'un nom d'axe soit assez peu compatible avec le pluriel (par 
exemple parent ou self, encore que self intervienne plus souvent dans un predicat) ; 
dans cecas on recti fie, pour rendre la phrase plus conformea I'intuition. 

I parent: :chapitre/child: :section/attribute: :niveau 

Ce qui donne : les niveaux qui sont les attributs des sections qui sont les enfants du cha- 
pitre qui est le parent du nceud contexte. 

Lecture d'un chemin de localisation avec predicats 

La presence de predicats perturbe incontestablement la fluidite de lecture d'un chemin de 
localisation, parce qu'elle contrarie le sens retrograde de lecture du chemin : 

j . . ./a: :b[c]/etapeN 

L orsqu'on commence la phrase de description, en partant de la fin, et qu'on arrive a a : : b, 
on doit a ce moment tenircompte d'un predicatcense restreindreun node-set construit en 
partant du debut, et non en partant de la fin. Or a ce point, on ne connait pas encore le 
node-set qu'il s'agit de filtrer. Ce probleme n'est pas toujours bloquant, car certains pre- 
dicats, notamment ceux qui ne font pas appel a la fonction predefinie positiono, 
s'accommodent assez bien de la souplessede la langue naturelle. 

I child: :chapit re/child: : sect ion [child: :figure] /attribute: : niveau 

Lecture : 

• ( I ) : L es 

• (E) : niveaux qui sont les attributs 

• (S) : des 

• (E) : sections (ayant des enfants yzgure) qui sont les enfants 
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• ( s ) : des 

• (E) : chapitresqui sontlesenfants 

• (F) : du noeud contexte 

Ici, parler de <section> sans restriction, ou d'elements <section> ayant des enfants 
<figure> ne cliange pas grand cliosea la structure de la phrase qui reste comprehensible, 
meme si I'origine deces <section> est miseen attenteet reporteea la fin de la phrase. 

Cependant, lorsqu'un predicat fait usage de la fonction posuiono, 11 est plus difficile de 
formuler une phrase comprehensible, parce que cette position est relative a un node-set 
enumerable que I 'on ne connait pas encore. 

Une solution, qui marche a tous les coups, consiste a mettre en attente le predicat, au 
moyen d' une note avec renvoi. 

chi 1 d: :chapi tre/chi Id: :section[posi tion( ) =2] /attribute: : niveau 

• (I) : Les 

• (E) : niveaux qui sont les attributs 

• (S) : de(s) 

• (E) : certaines(l) sections qui sontlesenfants 

• (S) : des 

• (E) : chapitresqui sontlesenfants 

• (F) : du noeud contexte 

• (note 1) uniquement celle qui a la position 3 dans I'ensemble de sections dont 11 est 
question. 

Lecture d'un chemin de localisation dans un predicat 

II peut arriver de rencontrer un predicat qui contienne lui-mame un chemin de localisa- 
tion : 

child: :paragraphe[ child: :figure/attribute: :scale ] 

II y a alors une difference essentielle entre la lecture d'un chemin de localisation en tant 
que tel, et la lecture d'un chemin de localisation faisant partie d'un predicat, comme ci- 
dessus. En effet, dans le premier cas, 11 s'agit de construire un node-set dont la comple- 
tude est primordiale; dans le deuxieme cas, il s'agit seulement d'evaluer ce node-set 
comme expression booleenne : il peut bien y avoir 3000 elements dans le node-set, peu 
importe : un seul suffit pour savoir qu'il est non vide et donner la reponse booleenne. 

II en serai t de meme, si I 'on avait : 

child: :paragraphe[ child: :figure/attribute: :scale = "0.5" ] 

On n'aurait que faire de connaitre in-extenso le node-set child: :figure/attribute: : 
scale, il nous suffiraitde savoir si au moins un element du node-set est egal a "o.5". 
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Dans ces conditions, il devient possible de lire lechemin de localisation du predicatdans 
le sens normal, car on n'a plus besoin de formuler une phrase qui exprime la totalite du 
contenu des etapes de localisation traversees. 

A insi, les etapes de localisation ci-dessus peuvent se lire respectivement : 

• les <paragraphe> (ayant un enfant <figure> ayant un attribut scale) qui sont les 
enfants du noeud contexte ; 

• les <paragraphe> (ayant un enfant <figure> ayant un attribut scale egal a "o.s") qui 
sont les enfants du noeud contexte. 

Naturellement, les expressions « ayant un enfant » ou « ayant un attribut » signifient en 
fait« ayant au moins un enfant » ou « ayant au moins un attribut ». 

Remarque 

II ne faut pas considerer que lorsque revaluation de deux predicats exprimes sous la forme de chemins de loca- 
lisation donne le meme resultat, les chemins de localisation associes sont equivalents. 



Par exemple, les deux predicats ci-dessous donnent le meme resultat : 

|child::paragraphe[ child: ifigure/attribute: iscale ] 
child: :paragraphe[ child: :f1gure[ attribute: :scale ] ] 

Pourtant, les chemins de localisation associes, a savoir child: rfigure/attribute: : 
scale et child: :figure[ attribute: : scale ] sont differents, puisque le premier selec- 
tionnedesattributs scale, alors que ledeuxiemeselectionne des elements <figure>. II se 
trouve simplement que ces deux chemins de localisation selectionnent des node- sets tou- 
jours simultanement vides ou toujours simultanement non vides, ce qui les rend equiva- 
lents du point de vue de la conversion en booleen. 

Examples de chemins de localisation 

I child: :bloc/descendant: :figure 

selectionne les <f i gure> qui sont des descendants des <bi oc> enfants du noeud contexte. 

I chi 1 d: :bl oc[pos1 tion( ) =3] /child: :f igure[position( [attribute: :type=' gif ' ] 

Selectionne les <figure> ayant un attribut "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <bioc> enfant du noeud contexte. 

parent: :node( )/child: :figure 

Selectionne les <figure> enfants d'un noeud quelconque parent du noeud contexte. 

' /descendant: :figure[pos1tion( ) = 42] 

Selectionne la figure qui a la position 42 parmi les descendants de la racine du document. 

I I s'agit done de la quarante-deuxieme <f i gure> dans I 'ordre de lecture du document. 

I /chi 1 d: :doc/chi id: :chap1 tre[pos1 tion( )=5]/chi 1 d: :section[posi t1on( )=2] 
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selectionne la deuxieme <section> enfant du cinquieme <chapitre> enfant de ('element 
<doc> enfant de la racinede I'arbreX M L. 

Ichild: :chapitre[ descendant: : note/child: :paragraphe/ 
attribute: :al ignement = "centre" ] 

Selectionne I es <chapi tre> enfants du noeud contexte, qui ont pour descendants des <note> 

ayant pour enfants des <paragraphe> ayant un attribut al ignement egal a "centre", 
' /descendant::*: not( child::* ) ] 

sel ecti onne I es feui 1 1 es de I 'arbre X M L du document source, c'est-a-di re I es elements qui 
n'ont pas d'enfant. Sans le predicat, on selectionne tous les elements qui figurent parmi 
les descendants de la racine ; le predicat [ child: :* ] filtrece node-set en ne retenant que 
les elements qui ont au moinsun enfant, quel qu'il soit; le predicat [ note child::* ) ] 
agit de fafon inverse, en ne retenant que les elements qui n'ont aucun enfant, 



Formes courtes des chemins de localisation 

Principe 

Vous I'aurez remarque, XPath est un langage assez verbeux ; c'est pourquoi I! existe des 
abreviations standard pour certaines constructions frequemment utilisees. Ces abrevia- 
tionssimplifient les ecritures, mais pas la comprehension des expressions un peu compli- 
quees, car dies ont tendance a masquer le detail des relations qui existent entre les 
differents constituants d'une expression, alors que ces details sont indispensables pour 
appliquer I'algorithme de lecture (voir C\e pour la lecture d'un chemin de localisation, 
page 64), Lorsqu'on bute sur une expression difficilement comprehensible, la premiere 
chose a fai re est done d'eliminertoutes les abreviations pour reveniraux formes completes, 

Ceci etant, 11 estvrai que dans les expressions usuellesqui neposent aucun problemede 
comprehension, ces abreviations sont les bienvenues. On noteraquel'emploi de la forme 
courte de child: :norti revient a sous-entendre la relation de parente enfant de dans les 
phrases de description d'un chemin de localisation. 



Tableau 2-1 - Abreviations standard 



Forme longue 


Abreviation 


child: :nom 


noin 


child: :* 


* 


attribute: :nom 


@nom 


attribute::* @* i 


[position( ) = x] 


[X] 1 


self::node() 


parent: :node( ) 


/descendant-or-self : :node( )/ 


// 
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Exemples de chemins de localisation en formes courtes 

Voici quelques exemples d'utilisation de ces formes courtes ; pour chacune, on donne la 
forme longue equivalente. 

figure 

Forme longue : 
child: :figure 

selectionne les <figure> qui sont des enfants directs du noeud contexte. 

textO 

Forme longue : 
child: :text() 

Selectionne les enfants directs du nceud contexte qui sont des noeuds de type text, 

//figure 
Forme longue : 

/descendant -or- sel f: :node( )/child: :figure 

Selectionne les <figure> qui sont des enfants directs de n'importequel noeud descendant 
de la racine de I'arbreXM L (done selectionne toutes les figures, oil qu'elles se trouvent 
dans le document). Si <figure> est la racine du document, elleestaussi selectionnee, car 
la racine du document est enfant direct de la racine de I'arbre XM L (voir Nceud de type 
root, page 31), 

bloc//figure 
Forme longue : 

child: :bl oc/descendant-or-sel f : :node( )/child: :figure 

Selectionne les <figure> qui sont des enfants directs ou indirects des <bioc> enfants du 
nceud contexte. 

bloc[3]/figure[@type = 'gif'][l] 
Forme longue : 

chi 1 d: :bl oc[pos1 tion( )=3]/child: :figure[position( )=1] 

[attribute: :type='gif ' ] 

Selectionne les <figure> ayant un attribut "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <bi oc> du noeud contexte. 

. ./figure 
Forme longue : 

parent: :node( )/child: :figure 

Selectionne les <f i gure> du parent du noeud contexte. 
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.//paragraphe 
Forme longue : 

self: modeO/descendant-or-self : :node( )/child: iparagraphe 

selectionne les <paragraphe> qui sont des enfants directs ou indirects du noeud contexte. 

//*[not(*)] 
Forme longue : 

/descendant-or-sel f : modeO/child: :*[not( child: :*)] 

selectionnelesfeuillesdel'arbreXM L, Ici laformelongueestplusfacileacomprendre : 
les elements (n'ayant pas d'enfant) enfant de n'importe quel noeud de I'arbre (y compris 
la racine). 

Variantes syntaxiques 

Expressions diverses 

1 1 n'y a que tres peu de possi bi I ites pour former des expressions renvoyant des node-sets : 
on dispose decheminsdelocalisation, qui sont en eux-memes des expressions renvoyant 
un node-set, de references a des variables contenant un node-set (mais les affectations de 
ces variables ne sont pas du ressort du langage XPath), de parentheses, de I'operateur j 
(reunion ensembliste), et d'appels a des fonctions predefinies renvoyant un node-set (a 
savoirunefonction proprement XPath, idc ), etdeux fonctionsXSLT utilisablesdans une 

expression XPath, keyO et document ( )). 

Voici quelques exemples d'expressions manipulant ces divers ingredients : 

(/descendant: :figure[position( ) = 42]) 

renvoie un node-set contenant la quarante-deuxieme <figure> dans I'ordre de lecture du 
document. Cet exemple a deja ete vu, mais sans les parentheses, qui dans ce cas ne ser- 
vent a rien, mais ne font pas non plus de mal. Quoique... Ces parentheses ne font-el les 
vraiment pas de mal ? Voyez la section Enume'ration d'un node-set renvoy«? par une 
expression, page 71. 

/descendant: :figure | /descendant: : image 

renvoie un node-set contenant reunion de toutes les figures et de toutes les images du 
document. 

I / I document( 'charteGraphlque.xml ' ) 

renvoie un node- set contenant reunion de la racine de I 'arbredu document source et del a 
racine de I'arbre d'un document auxiliaire, contenu dans le fichier 'charteGraphi- 

que.xrtil ' , 

/descendant: :figure[ ©type = 'gif ] | $ineslmages 
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renvoie un node-set contenant reunion de tous les elements <figure> ayant un attribut 

type egal a "gif" et des elements du node-set $mes images. 

Evaluation d'une etape de localisation par rapport a un node-set 
renvoye par une expression 

Nous avons vu a la section Evaluation d'une etape de localisation par rapport a un node- 
set, page 63, comment faire pour evaluer une etape de localisation par rapport a un 
node-set. Maisrien n'empeche que le node-set soit renvoye par une expression ; en void 
quelques exemples : 

I document( 'charteGraphique.xml ' )/descendant: :figure[ @type = 'gif ] 

selectionne le node-set des elements <figure> (ayant un attribut type egal a "gif) qui 
sont les descendants de la racine de I'arbre X M L du document auxiliaire contenu dans le 

fiChier "charteGraphique.xml ". 

j (/descendant: :f1gure | /descendant: :iinage)/attribute: iscale 

Selectionne les scale qui sont les attributs des noeuds appartenant a la reunion des node- 
sets /descendant: :figLire et /descendant: :image. A noter qu'On aurait pu aUSSi eCrire 

I 'expression : 

' /descendant: :*[ self::f1gure or self::image ]/attr1bute: :scale 

qui aurait selectionne le meme node-set. 

' $monDocument/ch11d: :chapitre/section 

Selectionne les <section> enfants des <chapitre> enfants des elements contenus dans le 

node-set SmonOocument. 

N otez qu'une expression formee d'un chemin de localisation suivi d'une expression ren- 
voyant un node-set n'a aucun sens : 

Ichild: :chapitre/section/$monDocument <!-- aucun sens !! --> 
child: :chapitre/(ch11d: :section) <!-- aucun sens !! --> 

Enumeration d'un node-set renvoye par une expression 

Lorsqu'un node-set est constitue par une etape de localisation, 11 est associe a un axe de 
localisation qui est soit direct, soit retrograde. Cela permet de definir dans tous les cas 
des indices de proximite (voir Indices de proximite, page 53), et done de donner un sens 
a la notion d'enumeration d'un node-set : un node-set estenumere (quand besoin est) en 
suivant I'ordre des indices de proximite. 

M aissi le node-set est renvoye par une expression quelconque, on perd la notion d'axede 
localisation, done d'indices de proximite, done d'enumeration. Dans ce cas, la regie est 
de choisir arbitrairement I 'ordre de lecture du document pour enumerer les elements. 



Le langage XPath 

Chapitre 2 



Regie pour definir renumeration d'un node-set 

Deux cas sont a envisager : 

• soitle node-set fait partied'uneetapede localisation ; dans ce cas, un axe de localisa- 
tion est defini, done I es indices de proximite sont definis, ettoute enumeration se fera 
suivant I'ordre des indices de proximite ; 

• soit le node-set provient d'une expression X Path qui n'est pas une etape de localisa- 
tion : dans ce cas les enumerations se feront dans I'ordre de lecture du document. 

Exemple 

Le basculement entre ces deux cas peut etre assez subtil : le standard XPath donne un 
exemple limite qui est assez parlant dece point de vue : 

Enumeration imposee par indices de proximite 

preceding-sibl ing: ifigure 

Enumeration par defaut, suivant I'ordre de lecture du document 

I (preceding-sibl ing: ifigure) 

Dans le premier cas, on a une etape de localisation, done I'axe de localisation est deter- 
mine, et les indices de proximite interviennent pour donner I'ordre d'enumeration. 

Dans le deuxieme, ['expression precedente est mise entre parentheses. Cela produit 
I'effet decalculer un nouveau node-set, qui estevidemment identiqueau precedent, mais 
qui n'a paslestatutdenode-setfaisantpartied'une etape delocalisation. II en resulteque 
toute enumeration de ce deuxieme node-set se fera dans I'ordre de lecture du document, 
exactementa I ' inverse du premier cas, puisque I'axe choi si estun axe retrograde. 

Comme nous I'avons dit, cet exemple est un exemple limite : il ne faut pas croire que 
dans I a prati que, on est sans cesse confronts a ce genre de subti I i te. M ai s i I n'est pas mau- 
vais de I'avoir vu, et de se souvenir que I'enumeration d'un node-set depend de fagon 
cruciale de la prise en compte ou non d'un axe de localisation. 

Application d'un predicat a une expression renvoyant un node-set 

II est possible d'appliquer un predicate une expression renvoyant un node-set. Cequ'on 
a vu a la section Predicats, page 57, c'est I 'application d'un predicat a un node-set forme 
lors d'une etape de localisation. La difference, ici, est que le node-set n'est plus neces- 
sairement lie a une etape de localisation, done, si besoin est (notamment si la fonction 
predefinie positionc ) est employee dans le predicat), la regie indiquee a la section pre- 
cedente s'appli que. 

En reprenant I'exemple limite de la section precedente, on aura : 

I preceding-sibl ing: :figure[ positionO = 1 ] 

constitue I e node-set NS des <figure> qui sont des preceding-sibling du noeud contexte; 
dans ce node-set, selectionne la premiere <figure>. Comme I'axe preceding-sibling est 
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un axe retrograde, la figure selectionnee est done la derniere dans I'ordre de lecture du 
document. 

(preceding-sibl ing: :figure)[ positionO = 1 ] 

constitue le node-set NS des<figure> qui sontdes preceding-sibling du noeud contexte ; 
dans ce node-set, selectionne la premiere <f igure>. Comme ce node-set n'est lie a aucun 
axede localisation, c'est I'ordre de lecture du document qui intervient, et la figure selec- 
tionnee est done la premiere dans I'ordre de lecture du document. 

Voici maintenantd'autresexemples : 

(//paragraphe | //noteBasDePage) [ child: :text( ) 

[ containsC sel f : :node( ) , "predicat" ) ] 

] 

Selectionne tous les paragraphes ou notes de bas de page du document, pourvu qu'ils 
aient au moins un enfant de type text qui contienne « predicat » dans un noeud qui soit 
self. Ou encore, en simplifiant les redondances, pourvu qu'ils aient au moins un enfant 
de type text qui contienne « predicat ». A utrement dit : selectionne tous les paragraphes 
ou notes de bas de page qui parlent de predicat, 

I $meslmages[@type = 'gif'l 

Selectionne les elements du node- set reference par la variable $mes images, ayantun attri- 

but type egal a 'gif, 

$p[ count( self::node() | $q ) = count( $q ) ] 

Selectionne les elements du node-set reference par la variable $p, qui appartiennent aussi 
au node- set reference par la variable $q. C'est la fameuse expression qui permetdecalcu- 
ler I 'intersection dedeux node-sets : voir Appartenance et test d 'inclusion, page 44. 
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Au coeur du langage XSLT 



Ce chapitre a pour but de rendre intelligible le fonctionnement de ce langage, non pas en 
le montrant en action, car le voir fonctionner n'explique rien, mais en allant au coeur des 
mecanismes qui regissentson comportementdynamique. 

Pour cela, nous presenterons la structure generale d'un programme X SLT, qui met claire- 
ment en evidence les deux piliers du langage, que sont le motif et le modele de transfor- 
mation ; puis nous demonterons le moteur de transformation, en faisant ressortir les 
etapes du processus general de traitement. Ensuite nous revisiterons en detail, d'abord 
les motifs et la concordance de motifs, puis les deux modeles de transformation fonda- 
mentaux, representes par les instructions xsi :vai ue-of et xsi :appiy-tempiates, dont la 
comprehension aboutit de facto a celle des autres instructions de transformation, qui ne 
sont rien d'autre que des variantes polymorphes et contingentes de ces deux-la, sans rien 
de nouveau dans I'essence meme des mecanismes. 



Structure d'un programme XSLT 

Un document (ou programme) XSLT est un document X M L, dont la racineest I'element 

stylesheet, etdont ledomaine nominal est "http://www.w3.org/1999/XSL/Transform", 

general ementabrege en "xsi :". 

Un programme XSLT a done I'aiiuresuivante : 

<?xml version="1.0" ?> 

<xsl : stylesheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transform"> 
</xsl :stylesheet> 

L'abreviation dedomaine nominal "xsi:" est celle qui esttraditionnellement utilisee. 
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M ais bien sur, comme toute abreviation de domaine nominal, elle n'est qu'une abrevia- 
tion possible, et I'on est libred'en choisir une autre (par exemplexsit:), du moment que 
le domaine nominal restelememe: 

<?xml version="1.0" ?> 

<xsl t: styl esheet xmlns :xsl t="http: //www. w3.org/1999/XS L/Transform"> 
</xslt:stylesheet> 

Remarque 

La declaration de ce domaine nominal etant obligatoire, tous les elements propres a XSLT seront done neces- 
sairement prefixes par I'abreviation de domaine nominal choisie ; autrement dit, toute balise dont le nom ne 
serait pas prefixe par "xsi : " (en supposant que c'est celle-la que Ton a choisie) serait consideree par le proces- 
seur XSLT comme du XML ordinaire n'ayant rien a voir avec XSLT. 

Comme un programme XSLT est un document XML, tous les aspects lexicaux sont du 
ressort d'XML et non d'XSLT : la syntaxe pour les noms d'elements, d'attributs, les 
caracteres interdits dans les valeurs d'attributs, etc., tout ceci est determine par le langage 
X M L et non par X SLT proprement dit. 

Elements XSLT, instructions, et instructions de premier niveau 

Un element XSLT est un element XM L dans le domaine nominal de XSLT, done de la 
forme <xsi :xxx>, si toutefois I'abreviation choisie est bien xsi : (ceque nous supposons 
etre vrai partout dans la suite). 

Une instruction est un element XSLT, 

Certaines instructions sont des instructions de premier niveau : ce sont des elements 
XSLT enfants directs de la racine <xsi :styiesheet>, 

Remarque 

Le standard XSLT 1 .0 parle de « top-level element » (que nous avons traduit par « instruction de premier 
niveau », puisque pour nous, « element XSLT » et « instruction » sont synonymes), et emploie le mot « instruc- 
tion » dans la grammaire XSLT, mais sans vraiment le definir. 

L'alluregeneraled'un programme XLST est done celle-ci : 

r <?xirl version="1.0" ?> 

<xsl : styl esheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transforin"> 
<!-- instructions de premier niveau --> 

<!-- fin des instructions de premier niveau --> 
</xsl :stylesheet> 

Les differentes instructions sont assez peu nombreuses, et nous les verrons au fur et a 
mesure que nous en aurons besoin dans la suite de ce livre ; la plus importante d'entre 
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elles, <xsi : tempi ate match=" . . .">est celle qui permet de definir une regie de transfor- 
mation, etc'estbien sur parellequ'il faudra commencer 

L e standard XSLT 1,0 donneau tout debut un exemplede programme XSLT tres varie en 
instructions : 

<xsl :stylesheet 
version="1.0" 

xmlns :xsl="http: //www.w3.org/1999/XSL/Transform"> 

<xsl: import href ="..."/> 

<xsl : incl ude href="..."/> 

<xsl : St rip- space el ements=" ..."/> 

<xsl : preserve- space elements^" ..."/> 

<xsl:output method=" . . . "/> 

<xsl:key name="..." match="..." use="..."/> 

<xsl idecimal -format name=" . . . "/> 

<xsl :namespace-alias 

styl esheet-pref ix=" ..." 
result-prefix=" . . . "/> 

<xsl :attribute-set name="..."> 

</xsl :attribute-set> 

<xsl : variabl e name=" ...">.. .</xsl :vari able> 
<xsl :param name=" ...">.. .</xsl :param> 

<xsl : tempi ate niatch=" . . . "> 

</xsl itempl ate> 

<xsl : tempi ate name="..."> 

</xsl :templ ate> 

</xsl :stylesheet> 

II nes'agitpasici d'expliqueraquoi correspondent ces instructions, maissimplementde 
prendre contact avec I 'allure d'un programme XSLT, 

Voici un autre exemple, moins riche en variete d'instructions, mais complet, sans points 
de suspension : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl istylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'html ' encodings' ISO-8859-r /> 



<xsl :template match="/"> 
<html> 
<head> 
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<title><xsl :value-of sel ect="/Concert/Entete"/></titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-teniplates/> 
</bocly> 
</html> 
</xsl :templ ate> 

<xsl itempl ate match="Entete"> 

<p> <xsl :value-of select="."/> presentent </p> 
</xsl itempl ate> 

<xsl itempl ate match="Date"> 

<H1 al ign="center"> Concert du <xsl ivalue-of select="."/> </Hl> 
</xsl itempl ate> 

<xsl itempl ate match="Lieu"> 

<H4 al ign="center"> <xsl i val ue-of select="."/> </H4> 
</xsl itemplate> 

<xsl itempl ate match="Ensembl e"> 

<H2 al ign="center"> Ensemble <xsl ival ue-of sel ect=" . "/></H2> 
</xsl itempl ate> 

<xsl itempl ate match="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl ival ue-of select="."/> </H3> 
</xsl itempl ate> 

</xsl istylesheet> 

De toutes les instructions, la plus importante, celle qui caracterise le plus le langage 
XSLT, c'est I 'instruction <xsi i tempi ate match=". . . ">, qui definit cequ'on appelle une 
regie de transformation : XSLT est un langage de transformation base sur des regies de 
transformation, 

Regies de transformation 

XSLT est un langage declaratif, a la maniere de Prolog. On ne decrit pas des actions a 
enchainer en sequence, mais des regies de transformation a appliquer suivant les cas qui 
se presentent ; de sorte qu'en general, I'ordre dans lequel ces regies sont enoncees n'a 
aucune influence sur le fichier resultat. 

Un processeur XSLT traite un document XML en parcourant les elements de I'arbre 
XML correspondant, et en appliquant a certains d'entre eux une regie de transformation 
choisie parmi I 'ensemble des regies constituant le programme XSLT, 

Un programme XSLT se compose done essentiellement d'une sehe de regies, chaque 
regie etant constituee de deux parties : 

• Un motif (pattern). Exprime en X Path, il ditsi i'eiementcourantestou non atraiter 
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• Un modelede transformation (template), qui dit par quoi remplacer I'element cou- 
rant, dans le cas ou il correspond au motif. 

Remarque 

Pour etre complet, ajoutons qu'un programme XSLT peut aussi integrer, en tant qu'instruction, des elements plus 
proches de la programmation classique, qui s'apparentent aux variables et aux fonctions, et permettent de 
realiser des algorithmes. De ce point de vue, XSLT est un langage fonctionnel pur. Pour les connaisseurs, disons 
qu'il ressemble a un CamI hyper-light (ce qui fait de XSLT un langage tenant a la fois de CamI et de Prolog). Pour 
les autres, disons en un mot qu'un langage fonctionnel est un langage de programmation dont I'une des carac- 
teristiques (en fait la seule qui nous interesse pour comparer a XSLT) est que la notion de variable dont la valeur 
peut evoluer au cours du temps n'a aucun sens. On est done dans un monde extremement different de celui de 
C ou de Java : il ne faut surtout pas projeter sur XSLT les connalssances qu'on peut avoir de la notion de variable 
ou de fonctlon tirees de la pratique de C ou Java. 

Mais XSLT n'est pas encore un langage de plus pour I'algorlthmique : II y en a deja sufflsamment comme ?a sur 
le marche ; c'est un langage de manipulation d'arbres, et en tant que tel, ce sont les regies XSLT (avec leur motif 
et leur modele de transformation) qui sont essentielles, et non pas les possibilltes offertes dans le domaine de la 
programmation algorithmique. Cela ne veut d'ailleurs pas dire qu'elles sont inutiles ; elles sont meme parfois 
indispensables, mais n'ont de sens que comme complement a I'essentlel (la manipulation d'arbre). 



Forme d'une regie XSLT 

Une regie XSLT (ou regie de transformation), constituee d'un motif et d'un modele de 
transformation, se presente sous la forme d'une instruction <xsi : tempi ate> dontl'attribut 
match fournit le motif, et dont les noeuds enfants constituent le modele de transformation : 

<xsl : tempi ate match=" . . .pattern. . . "> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 

Le motif, ou pattern, fourni en tant que valeur de I'attribut match, s'exprime sous la 
forme d'une expression X Path vehfiant des contraintes parti culieres. 

Note 

Lexistence de ces contraintes ne doit pas suggerer que XPath est un langage mal congu car trop puissant pour 
I'usage qu'on en a ; en effet, XPath, en tant que langage general d'expressions designant des sous-arbres dans 
un arbre XML, est utilise aussi bien pour XSL que pour XPolnter (et bientot XQuery). La puissance expressive de 
ce langage n'est done pas forcement utilisable en totalite dans tous les contextes. 

Modele de transformation 

L e modele de transformation decrit ce par quoi il faut remplacer le sous-arbre que le motif 
designe (ou les sous-arbres si I e motif en designe plusieurs). Ce peut etre du texte simple : 



<!-- modele de transformation --> 
bla bla ... 
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'' bla bla ... 

^ <!-- fin du modele de transformation --> 

Ce peut etre aussi du texte agremente de valeurs tirees de sous-arbre(s) designe(s) par 
une expression X Path quelconque (ici, pasde restriction sur I'emploi deXPatli) : 

<!-- modele de transformation --> 
I bla bla ... 

I ici, une instruction XSLT qui va provoquer 1 'insertion, 
I a cet endroit, de la valeur de I'attribut "nom" de 1 'element <personne> 
I qui se trouve a tel endroit dans I'arbre XML du document 
bla bla ... 

' <!-- fin du modele de transformation --> 

Bien stir, on peut deja se douter que la valeur de I'attribut nom de I'element <personne> se 
trouvant a tel endroit dans le document XML sera expri mee sous la forme d'une expres- 
sion XPath de la forme : 

.../.. ./personne/attribute: :nom 

Comme toute la puissance de XPath est ici utilisable, on imagine facilement qu'il y a 
beaucoup d'autres possibilites : recuperation du contenu d'un element, evaluation d'une 
fonction sur un ensemble d'elements, et tout autre calcul du meme genre, pourvu qu'il 
soitexprimable en XPath : 

r <!-- modele de transformation --> 
bla bla ... 

inserer ici le contenu de I'element <description> qui se trouve cl 
tel endroit dans I'arbre XML du document 
bla bla ... 

<!-- fin du modele de transformation --> 

Ou encore : 

<!-- modele de transformation --> 
bla bla ... 

inserer ici la somme des valeurs des attributs "prix" 
des elements <produit> qui se trouvent a 
tels et tels endroits dans I'arbre XML du document 
bla bla ... 

<!-- fin du modele de transformation --> 

Par ailleurs, le texte peut lui-memeetre balise en XML (par exemple en XHTML ou 
HTML4) : 

<!-- modele de transformation --> 
<BR/> bla bla ... 

|<p> 
inserer ici la somme des valeurs des attributs "prix" 
des elements <produit> qui se trouvent a 
tels et tels endroits dans I'arbre XML du document 
</p> 

<Hl>bla bla ...</Hl> 

<!-- fin du modele de transformation --> 



Structure d'un programme XSLT 

Chapitre 3 



1 1 faut rappeler ici que le balisage eventuel en X M L (ou variante d'X M L ) du texte consti- 
tuant le model e de transformation doit respecter la structure de document bien forme 
imposee par le standard XM L. II est done impossible de baliser le texte en HTM L ordi- 
naire, a cause des balises comme <br>, <p>, <hr>, etc. qui n'ont pas necessairement de 
bal i se de f ermeture associ ee. 

La raison de cette restriction estfort simple : un programmeXSL est avant tout un docu- 
ment XML bien forme; lorsqu'on lance le processeur XSLT, le document XSL est 
d'abord I u de fagon standard par un parseur X M L , qui ne fait aucune difference de traite- 
ment entre les balises prefixees par "xsi :" et les eventuelles autres. Une fois construit 
I'arbreXML du documentXSL, le processeur XSLT entre en action ; il parcourt I'arbre 
XML obtenu, en interpretant les balises prefixees par "xsi :" comme autant d'instruc- 
tions, et en considerant les autres comme des bribes de donnees. 

Modele de transformation litteral 

Un modele de transformation litteral estun model ede transformation qui necontientque 
du texte et des elements X M L en dehors du domaine nominal de XSLT. C'est done un 
model ede transformation qui ne contient pas d'instruction XSLT, Un elementXM L non 
XSLT qui figure dans un model ede transformation s'appelle un element source litteral. 

Exempl e 

<xsl : tempi ate match^" . . .pattern. . . "> 

<!-- modele de transformation litteral--> 

Detail du rez-de-chaussee : 

<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 
</RDC> 

<!-- fin du modele de transformation litteral--> 
</xsl itempl ate> 

Ce model ede transformation est litteral, parcequ'il ne contient que du texte etun element 
XML non XSLT (<rdc>, ettoutesa descendance), qui est done un element source litteral. 



Un premier exemple de programme XSLT 

A pres ce survol tres rapide de la forme generale d'une regie X SLT, nous allons mainte- 
nant revenir sur I 'exemple vu un peu plus haut, afin de ne pas le quitter sans savoir ce 
qu'il peutproduire comme resultat. 
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Cet exemple, visible a la figure 3-1, n'est pas destine a expliciter le principe de fonction- 
nementdu langageXSLT, car malgre son apparentesimplicite, il esttrop complique pour 
un debut ; il ne faut done s'attacher qu'a apprehender la structure general e, sans s'arreter 
sur le detail des divers constituants. 



Concert.xsl 



<?xml version="1.0" encoding="UCS-2"?> 

<xsl:stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version-'!. 0"> 
<xsl:output method-html' encoding='ISO-8859-l' /> 



<xsl:template match="/"> 
<html> 
<head> 
<title> 

<xsl:value-of select="/Concert/Entete"/> 

</title> 

</head> 

<body bgcolor-'white" text="black"> 

<xsl:apply-templates/> 
</body> 
</html> 

<xsl:template> 

<xsl:template match-'Entete" 

<p><xsl:value-of select-'. "/> 
presentent</p> 

<x5l:template> 

<xsl:template match="Lieu"> 
<H4 align="center"> 
<xsl:value-of select-'. "/> 
</H4> 

</xsl:template> 



Netscape: «Les Concerts d'Anacreon» H B 



«Les Concens d'Anacreon^ presentent 

Concert du Jeudi 17 
anvier 2002, 20H30 

CMpelle des Ursntes 

Ensemble «A deux violes essal 

/ .Oeuvres de 

M.. Marais/^D. Castello, F. Rognoni 




-S^ )^ 1^'^ bjJ 



<xsl:template match="Date"> 

<H1 align="center"> 

Concert du <xsl:value-of selec5?^"."/> 

</Hl> 
</xsl:template> 

<xsl:template match-'Ensemble": 
<H2 align="center"> 
Ensemble 

<xsl:value-of select-'. "/><yH 2 
</xsl:template> 

<xsl:template match-'Composit^ 

<H3 align="center">/ 

Oeuvres de <br/> 

<xsl:value-of select-'. "/> </H3> 
</xsl:template> 

<xsl:stylesheet> 



t.xml 



^xml version="1.0" encoding="UCS-2" standalone="yes"?> 
<Concert> 

<Entete>«Les Concerts d'Anacreon» <yEntete> 
<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Cliapelie des Ursuies</Lieu> 

<E nsembie> «A deux vioies esgales» </E nsembie> 

<Compositeurs> 

M. Marais, D. Casteilo, F. Rognoni 
</Compositeurs> 

<yConcert> 



Figure 3-1 

Un exemple de transformation XML vers HTM L. 
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M algre tout, il reste suffisamment simple pour qu'on puisse intuitivement entrevoir de 
quelle maniere il transforme en HTM L lefichierXML propose en entree. 

C'est ainsi qu'en observant le fichier XM L donne et le resultat obtenu, on imagine bien 
que la transformation XSL consistetout simplementa deshabiller letextedeses di verses 
balisesXML pour le rhabiller de balises HTM L (XHTML plus exactement, pourconser- 
ver la structure de document bien forme), en respectant I'ordre dans lequel les elements 
XML apparaissent dans le fichier donne. Notez bien qu'il ne s'agit pas de I'ordre dans 
lequel les regies sont donnees : voyez en particulier le croisement entre la regie pour le 
lieu etia regie pour la date. 

Rien de bien extraordinaire dans tout cela, une simple feuille de style CSS pourrait en 
faire autant. Quoique ... Aviez-vous remarque que le contenu de I'element <Entete> 
intervient deux fois dans le resultat, une fois comme titre de la fenetre du navigateur, et 
une fois dans le texte proprement dit ? 

Lancement du processeur XSLT 

A titre indicatif, et pour fixer les idees, void la commande (avec Saxon) qui a permis 
d'obtenir le resultat ci-dessus : 

Ligne de comtnande (d'un seul tenant) 

Java -classpath "C:\Prograni Files\JavaSoft\SAXON\saxon.jar;" 

com. icl .saxon. Stylesheet -o Concert. html Concert. xml Concert. xsl 



Principe de fonctionnement d'un processeur XSLT 

Le principede fonctionnement d'un moteurXSLT est important a comprendre, caril est 
normalise, done parfaitement previsible ; ecrire(ou concevoir) une feui I lede style XSLT, 
c'est done prevoir le comportement du processeur XSLT face a la feuille de style qu'on 
se prepare a lui proposer. 

Note 

Cela ne veut pas dire que le resultat produit par un programme XSLT soit toujours facile a prevoir dans ses 
moindres details, Mais en fait, une divergence entre le resultat obtenu etce que I'on imaginait obtenir peut 
passerplus ou moins inapergue :parexemple, une mauvaisegestion des espaces blancs (espaces, tabulations, 
sauts de lignes) estsans importance pour la generation d'un fichier HTML, mais plus problematique pourcelle 
d'un fichier RTF. Neanmoins, comme le comportement du processeur XSLT est bien surdeterministe, toutfinit 
pars'expliquer, meme si c'est parfois un peu ardu. 

L'ecriture de feuilles de style par analogie et recopie de feuilles de style existantes, sans 
compreliension reelle du fonctionnement sous-jacent, est naturellement possible, mais 
cela reste limite a des feuilles de style simples, basees sur des structures simples et en 
nombre limite, qui finissent par devenir familieres. 
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Le but de cette section est defournirune representation conceptuelledu modele detrai- 
tement d'un moteur XSLT. Bien que conceptuelle, cette representation est conforme au 
standard W3C, mais ce n'est qu'une representation : rien n'oblige (mais rien n'interdit 
non plus) les auteurs de processeurs XSLT a respecter a la lettre cette description dans 
leur implementation ; 11 suffitqu'ils la respectentdans leprincipe, du moment que globa- 
lement, leur processeur fonctionne comme nous allons I'expliquer maintenant. 



Construction - serialisation 

L e processeur X SLT opere sur un arbre XML, construit au lancement du processeur par 
un parseur XM L, a partir d'un fichier XML. Ce processus s'appelle la construction de 
I'arbre ; le processus inverse, qui permet I'obtention d'un fichier X M L a partir d'un arbre 
XML, s'appelle la serialisation (voir figure 3-2). 



Figure 3-2 

Construction 
Serialisation. 



Document XML 



<Concert> 

<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford <VNom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
</lnterpretes> 
</Concert> 

Construction 



Serialisation 



Date 



^root 
^Concert 

Lieu^ Interpretes 



janv!e"2002, des^"" Interprete Interprete 

20H30 Ursules 9 9 

Norn Instrument Norn Instrument 



Jonathan Basse Silvia Basse 
Dunford de viole Abramowicz de viole 

Arbre XML du document 
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Ces deux representations document/arbre sont equivalentes, de sorte que toute operation 
sur I'arbre XML peut se transposer en une operation equivalente sur le document, et 
reciproquement. 

Les trois phases du processus complet 

Le processeurXSLT operesur I'arbreXM L du document, appele arbre source, dont les 
elements sont des no-uds source. La transformation consiste a produire un nouvel arbre 
XML, appele arbre resultat. 

La Serialisation de cet arbre resultat produit un document resultat qui peut etre un docu- 
ment XM L, un document HTM L 4 ou X HTM L, voire un simple texte non balise. 

Le processus complet est done un enchatnementde trois operations : construction, trans- 
formation. Serialisation (voir figure 3-3). 

Specification d'une transformation 

Une transformation XSLT est une suite d'operations elementaires sur un arbre XML, 
produisant un nouvel arbre XML. Une transformation XSLT peut done etre specifiee 
d'une fa^on tres naturelle et directe en termes d'operations sur un arbre. Mais etant 
donne I 'equivalence des representations arbre/document, 11 est egalement tout a fait pos- 
sible de la specifier en termes d'operations sur un document. 

Par ailleurs, le processeur X SLT n'effectuejamais de modification sur I 'arbre source ori- 
ginal : 11 secontentedeconstruireun nouvel arbre, de sorte que les seules operations ele- 
mentaires utiles sont celles qui consistent a grefferun nouveau morceau d'arbre a I'arbre 
en cours de construction. Transposees a la representation par document, ces operations 
de greffes se reduisent a des concatenations de fragments de documents ou d'inclusions 
d'un fragment de document dans un autre. 

Note 

La concatenation de deux documents donnes estun nouveau document, obtenu en les mettant bout a bout dans 
I'ordre ou ils sont donnes. 

Or 11 se trouve que d'un strict point de vue redactionnel, 11 est beaucoup plus simple de 
s'exprimer en termes de manipulation de document qu'en terme de construction d'arbre 
(c'est I 'inverse en programmation, oiiil est beaucoup plus facile d'exprimer une transfor- 
mation d'arbre qu'une manipulation de document). C 'est pourquoi dans toute la suite, 
nous avons de1ib«?r«?mentfait le clioix d'exprimer les effets des transformations et des ins- 
tructions XSLT en termes de construction de documents a partir de fragments de docu- 
ments, et non en termes de construction d'arbres a partir de sous-arbres. 
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Modele de traitement 

Nous allons maintenantvoir un resume synoptiquedu modele de traitement d'un proces- 
seurXSLT, qui sera decline en plusieursetapes. Chaqueetapefait reference a la suivante, 
sauf la dernierequi peuteventuellement revenir recursivement en arriere. 

Ce resume synoptique est assez general, car 11 ne rentre pas dans le detail de I'effet de 
chaque instruction XSLT. II secontentededecrirelemecanisme ; mais plus loin (Les ins- 
tructions de transformation, page 127), nous verrons dans le detail chaque instruction 
importante de X SLT, et nous aurons I 'occasion de preciser finement le deroulement de ce 
model ede traitement pour chacunedeces instructions. 

Traitement du document XML source 

Au depart du traitement, une liste de noeuds source initiale est constituee, ne contenant 
que la racine de I'arbre XM L du document a traiter (figure 3-4). Le traitement du docu- 
ment consiste a traiter la liste de noeuds source initiale. 



Figure 3-4 

Traitement du 
document XM L 



<Entete> «Les Concerts d'AnacreoP" <Entete> 
<Date>Jeudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 



<html> 
<head> 

<META http-equiv-"Content-Type" content-'text/htmi; 
charset=ISO-8859-l"> 



<title> «Les Concerts d'Anacr&eacuteion» 
<title> 
<head> 

<body text-'black" bgcolor="white"> 



source. 



<Ensemble> «A deux violes esgaleS" <yEnsemble> 



<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
<Compositeurs> 



<p>&[laquo;Les Concerts d'Anacréon» 
présentent <p> 



DocumentXML a traiter 



<H1 align^"center"> Concert du J eudi 17 J anvier 2002, 
20H30</H1> 



<H4 align-"center">Chapel!e des Ursjles</H4> 




<H2 align="center"> Ensemble S(laquo;A deux violes 
esgales» <H2> 



<H3 align-"center"> Oeuvres de <br> 



<body> 
<html> 



Rognoni 



Document resultat 



M, Marais, D, Castello, F. 



Arbre XML du document a traiter 




Liste a traiter 



root 



Traitement 
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L e document final obtenu lors de ce traitement est le document resultant du traitement de 
cette liste. 



Traitement d'une liste de noeuds source 

Le traitement d'une liste de noeuds source consiste a traiter separement chaque noeud 
source dans I'ordre ou il apparait dans la liste (figure 3-5), ce qui produit en resultat 
autant de fragments de documents qu'il y a de noeuds source a traiter 

L e document resultat du traitement de la liste est la concatenation des fragments de docu- 
ments obtenus separement, 



Traitement 
(l)+(2)+...+(n)+(n+l) 



Fragment de document 
resultat du traitement de la 
liste de noeuds 



Liste de noeuds a traiter 

Noeud n 



Noeud 1 Noeud 2 
• • 



Traitement Traitement 
d'un noeud d'un noeud 
(1) (2) 



Traitement 
d'un noeud 
(n) 



T T T 

FD 1 - FD 2 — FD n 



Fragments de documents 

Figure 3-5 

Traitement d'une liste de nauds source 



Fragments 
de 

documents 
concatenes 



Concatenation 
(n+1) 




Traitement d'un nceud source membre d'une liste de noeuds source 

Le traitement d'un noeud source consiste a rechercher, parmi I'ensembledes reglesXSLT 
definies dans le programme XSLT, celle dont le motif correspond au noeud traite, puis a 
appliquer cette regie, relativement a un noeud courant qui est le noeud traite, eta une liste 
courantequi est I a liste de noeuds source. 

• Si aucune regie n'est trouvee, une regie par defaut, possedant un modele par defaut, 
estappliquee. 

• Si plusieurs regies sont trouvees, un algorithme de calcul de priorite permet normale- 
mentd'en selectionner uneetuneseule(sinon le programme XSLT est incorrect). 
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L'application de cette regie (relativement a son noeud courant et a sa liste courante), 
consiste a instancier le modele de transformation associe (relativement au meme noeud 
courant et a la meme liste courante), ce qui produit un fragment de document qui est le 
resultat du traitement du noeud source (figure 3-6). 



I 



Programme XSLT 
Motif 1 

Modele 1 



^ ^ concordance 

0"< Motif 2 



Liste contexte 



NcEud a traiter 
(Noeud contexte) 



Modele 2 



Motif n 



Modele n 



Figure 3-6 

Traitement d'un naud source 



instanciation 



FD 



Fragment de document 



Remarque 

L'experience montre que la liste courante intervient assez rarementdans l'application de cette regie : on pourra 
done, en premiere lecture, ignorerson existence, etfaire comme s'il n'en n'etaitpas question. 



Noeud courant - Noeud contexte 

II est souvent question, en XSLT, de noeud courant etde noeud contexte. II peut etre tentantde confondre ces 
deux notions, d'autantplus que la plupartdu temps, noeud courant et noeud contexte designentle meme noeud. 
Neanmoins ce sontdeux notions differentes. 

La notion de noeud contexte intervient dans revaluation d'une expression XPath : une expression estevaluee 
relativement a un nceud contexte. 

La notion de noeud courant intervient dans I'instanciation d'un modele de transformation : un modele est instan- 
cie relativement a un nceud courant 
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Or, dans ce processus d'instanciation, il est frequent qu'une expression XPath soitaevaluer :son evaluation se 
faitalors relativementa un noeud contexte qui estle nceud courant(ce qui explique pourquoi il peutetre tentant 
deconfondre noeud contexte et noeud courant) ;mais si cette expression contientun predicatfiltrantun node-set 
aplusieurs elements, le predicatsera evalue pourchacun de ses elements, qui seronttemporairement eta tour 
de role le noeud contexte de revaluation, alors que le noeud courant, lui ne change pas (ce qui explique pourquoi 
il ne feut pas confondre noeud contexte et noeud courant). 

En resume, pourne pas se tromper, mieux vauttoujours parlerde noeud courant pourun modele de transforma- 
tion etde noeud contexte pourune expression XPath, 

En deuxieme lecture, on pourra se reporter a la Remarque, page 191, qui detaille un peu plus precisement le 
processus d'evaluation d'un predicat 

Instanciation d'un modele de transformation relativementa un noeud courant 
et une liste courante 

L'instanciation d'un modele de transformation consiste a obtenir un fragment de docu- 
ment a parti r du modele. Pour cefaire, tout ce qui esttexte brut ou texteXM L en dehors 
du domaine nominal deXSLT (generalementdesigne par leprefixe "xsi :") est conserve 
tel quel lors de l'instanciation. Tout le reste consiste en des elements XSLT (<xsi:xxx> 
. . .</xsi :xxx>) qui sont remplaces par leur valeur, qui peut dependre du noeud courant, 
et meme parfois de la liste courante (par exemple lorsque I'une de ces valeurs est la 
valeur numehquedu numero d'ordredu noeud dans sa liste) ; s'ils n'ont pas de valeur, ils 
sont remplaces par rien (c'est-a-dire sont supprimes: rien est la valeur de remplace- 
ment). 

Instmction - Execution d une instruction 

Dans un modele de transformation, un elementXSLT de la forme <xsi:xxx> ... </xsi :xxx> s'appelle une 
instruction. Lors de l'instanciation d'un modele de transformation, ses instructions sont executees. L'execution 
d'une instruction consiste a la remplacer par sa valeur, dans le fragment de document resultat produit par 
l'instanciation du modele de transformation. On peut done parler aussi d'instanciation d'une instruction. 
L'ordre temporel d'instanciation des instructions n'est pas forcement I'ordre sequentiel de leur apparition dans le 
modele ; d'ailleurs on pourrait tres bien imaginer qu'elles soient executees dans un ordre aleatoire (ou bien 
toutes en meme temps, surun ordinateurmulti-processeurs). Si acestade, cela vous para it incroyable, reportez 
vous a la figure 3-7, ou I'on volt clairement que chaque instruction estresponsable de la creation d'un boutde 
texte qui vientse mettre asa place dans le fragment de document resultat : peu importe dans quel ordre tempo- 
rel les petits bouts de texte sontinseres dans le fragment de document resultat, du moment que I'ordre spatial 
dans lequel ils apparaissentrespecte I'ordre spatial des instructions dans le modele. 

L'evaluatlon de I'une des deux instructions XSLT <xsi :appiy-tempiates> ou <xsi :for- 
each> (et ce sont les deux seules) produit une nouvelle liste de noeuds source ; cette liste 
est alors recursivement traitee : comme toute autre liste de noeuds source, elle subit le 
traitement standard d'une liste (voir Traitement d'une liste de n^uds source, page 88), et 
la valeur de I'instruction <xsi :appiy-tempiates> ou <xsi :for-each> est alors egale au 
fragment de document obtenu en tant que resultat du traitement de cette liste (figure 3-7). 
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Fragment de 
document resultat 



recopie 



Texte ordinaire 



Texte resuitat 



remptaQe par 



FD 1 
FD 2 



FD n 



Concatenation 



Motifs (patterns) 

U n motif est une expression qui, evaluee par rapport a un certain nceud contexte, designe 
un certain ensemble de noeuds de I ' arbre X |V| L d'un document. 

Rappelons que le motif est la valeur de I'attribut match dans la definition d'une regie 
X SLT, et que cet attribut doit representer une expression X Path (vehfiant une contrainte 
particuliere qui sera explicitee un peu plus loin). 
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Donnons tout de suite un exemple : 

<xsl :template match="child: :Theatre/child: :*"> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Cet example s'applique a cefichier XM L : 

<?xml version="1.0" encoding="LITF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </HeLire> </Date> 

<Lieu>Chapelle des Llrsules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</LieLi> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Saison> 

L'expression child: :Theatre/chiid: :* veutdire« tous les elements XM L, qui sontdes 
fils de I'element Theatre, qui est un fils de». Ce qui ne veut pas dire grand-chose, la 
phrase s'interrompant brutal ement sans qu'on sache la fin de I'histoire. En fait, le motif 
ne peut rien dire de plus, et le renseignement qui nous manque, c'est le noeud contexte. 

II nefaut done jamais oublier qu'un motif a base de chemin de localisation relatif, c'est- 
a-dire ne commen^ant pas par un «/ » (voir Chemins de localisation, page 62), ne peut 
etre evalue que par rapport a un noeud contexte donne. Dans notre cas, si I'on prend le 
noeud <saison> comme noeud contexte, on peut alors evaluer completement le motif, qui 
designe I 'ensemble des elements qui sontdes filsd'un element <Theatre>, qui estun fils 
d'un element <saison> (voir figure 3-8). 

Le meme motif peut tres bien donner un ensemble vide, si on I 'evalue avec un autre 
noeud contexte. Cesera lecas, par exemple, si I'on prend I'un des deux noeuds <Theatre> 
comme noeud contexte, car 11 n'existe aucun element qui soit fils d'un element <Theatre> 
lui-meme fils d'un element <Theatre> (voir figure 3-9). 

Concordance de motifs 

Un noeud N de I'arbre XML etant donne, et un certain noeud contexte C etant ensuite 
choisi, si I'evaluation du motif par rapport au noeud contexte C donne un ensemble qui 
contient N , alors on dit qu'il y a concordance du motif avec le noeud N (voir figure 3-10). 
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Figure 3-10 

Concordance de motif. 
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La chose a remarquer ici, est que contrairement a ce que I'on pourrait imaginer, la 
concordance entre un noeud N et un motif est obtenue des lors que I 'ensemble de noeuds 
determine par I'evaluation du motif contient N : il n'est pas necessaire que cet ensemble 
se reduise au seul element N . 

Recherche de la concordance de motifs (pattern matching) 

Nous venons de voir a quelle condition il y a concordance entre un noeud N et un motif, 
un noeud contexte C etant donne. 

Nous allons maintenant voir comment le moteur XSLT effectue la recherche de concor- 
dance de motif, ou pattern matching. 

Le probleme est que dans ce processus, le noeud contexte C n'est plus donne : le but est 
alors precisement d'en trouver un, 

Ce qui est donne, maintenant, c'est le motif et le noeud N ; charge au moteur XSLT de 
determiner si le motif concorde avec ce noeud N . 

II peut prendre un noeud C au hasard dans I'arbreXM L, et I'utiliser comme noeud con- 
texte dans I'evaluation du motif ; si cela donne la concordance du motif avec le noeud N 
en cours d'examen, c'est gagne, il a la reponse. M ais sinon, c'est toujours I'incertitude : 
peut-etre qu'en choisissant un autre noeud C on aurait la concordance, mais peut-etre 
qu'il n'existe aucun noeud dans I'arbre XM L, qui pris comme noeud contexte, donne la 
concordance... 

Comment savoir ? 

U ne premiere idee, evidente, consisterait a effectuer le test de concordance en explorant 
I'un apres I'autre tous les noeuds de I'arbre, et en prenant a chaquefois le noeud courant 
comme noeud contexte pour evaluer le motif : des que I'on a trouve un noeud qui donne la 
concordance, on peut arreter. 

Le probleme est que s'il n'y pas concordance, on ne le salt qu'apres avoir teste infruc- 
tueusement chaque noeud de I'arbre I Et meme s'il y a concordance du motif avec le 
noeud N, on aura probablement commence la serie detests avec des noeuds contexte tres 
eloignesdu noeud N, avec unefaible probabilite d'obtenir la concordance, a moinsque le 
motif soit vraimenttres bizarre etcomplique, mettant en jeu des relations de parente tres 
eloignees entre le noeud N et le noeud contexte qu'il fall ait trouver... 

En fait, tout le probleme est la : pourquoi ecrire des motifs tres bizarres et compliques ? 
II nefaut pasoublierquelebut, dansl'ecritured'un motif, est si mplementde designer un 
certain noeud, ou une famille de noeuds, sur lesquels on veut qu'une certaine regie 
s'applique. 

Dans ces conditions, entre deux motifs qui pourraient egalement convenir, un simple et 
direct et un qui passe par le cousin de I'oncle du fils du frere, autant prendre le simple 
et direct. 
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D'ou I'idee de restreindre a priori la region de I'arbre dans laquelle la recherche sera 
effectuee, ce qui bien sur limitera le motif a des relations de parente compatibles avec 
cette region. 

Or, clairement, la region la plus favorable pour lancer une recherche a partir d'un noeud 
donne est celle qui est constituee des ancetres de ce noeud. En effet, la remontee vers un 
parent ne laisse jamais aucun choix, alors que la descente vers un enfant donne autant de 
choix possibles qu'il y a d'enfants : la remontee vers les ancetres s'apparente au simple 
parcours d'une liste lineal re, alors que la descente vers les enfants reste un processus 
eminemment arborescent et recursif. 

Si maintenant on veut que la recherche de concordance entre un motif et un noeud N 
donne ait une chance d'aboutir, alors qu'on limite a priori la recherche d'un noeud 
contexte convenable aux ancetres de N , il est imperatif que le motif ne fasse pas inter- 
venir d'autre axede localisation que child: :, 

D'ou la regie : 
Contrainte des ancetres 

Un motif ne peutmentionner aucun axe de localisation, sauf child: :. On verra {Syntaxe et contrainte pour un 
motif XSLT, page 98) que Ton peutquand meme relaxer un peu cette contrainte, car il y a des axes (comme 

attribute:: ou namespace: :) qui ne font paS de mal. 



Examinons cela sur un exemple (figure 3-11) : 




(T)-/a/b/c/d ( (vide) ) 
(T)./a/b/c/d ( (vide) ) 





Noeud N 




(4)'/a/b/c/d 



Figure 3-11 

Recherche de concordance. 
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Cet exemple montre un arbre XML avec deux noeuds <d> et leurs ancetres communs <b>, 
<c>, <a>. On suppose que I 'un desdeux noeuds <d> (en grise sur la figure) est lenoeud que 
I'on veut tester par rapport au motif suivant (exprime en syntaxe longue) : 

I chilcl::a/child: :b/child: :c/child::d 

Puisque dans le processus de recherche de concordance de motif, on decide de se li miter 

aux noeuds ancetres du noeud test, seuls les noeuds notes (1), (2), (3), (4) etc. (jusqu'a 

la racine de I'arbre) vont etre successivement choisis comme noeud contexte. En (1), 
devaluation du motif va renvoyer un ensemble de noeuds (node-set) vide, car lenoeud <c> 
n'a aucun enfant <a>. On refaitevidemmentlememe constat aux etapes(2) et(3). En (4), 
devaluation du motif renvoie un ensemble de noeuds constitue des deux elements <d> ; 
cet ensemble contient le noeud test: la concordance est done etablie, et la recherche 
s'arrete. 

M ais maintenantimaginonsqu'un motif puissementionner des axes de localisation quel- 
conques, et pas seulement child: :, et que I'on puisseecrire par exemple : 

^ chi Id: :a/fol lowing: :b/chi 1 d: :c/chi 1 d: :d 

Arrives a I'etape (2), nous ne pourrions plus nous permettre de remonter « betement» 
vers I'ancetre suivant, puisqu'a coup sur, nous irions a I'echec ; 11 nous faudrait aller 
explorer certains des freres, oncles et neveux de <b> (voir figure 2-10 a la section Repre- 
sentation graphique, page 50), et pour chacun d'eux remonter sa lignee d'ancetres. 

Ayant vu I'interet qu'il peut y avoir (en termed'efficacite) a limiter a priori la recherche 
de concordance de motifs a la seule lignee d'ancetres du noeud test, il faut maintenant en 
examiner les consequences sur le pouvoir expressif des motifs. 

M ais qu'est-ce que le pouvoir expressif d'un motif ? Est-ce sa capacite a ratisser large, 
ou au contraire a discriminer finement ? 

II n'y a aucun doute que c'est sa capacite a discriminer finement ; un exemple de motif 
ne discriminant pas grand-chose serait child: :node( ) : un tel motif concorde avec 

n'i mporte quel noeud de type element node, comment node, processing instruction 

node, OU text node (voir Modele arborescent d'un document XML vu par XPath, 
page 30). 

Autant dire que si on equipe une regie d'un tel motif, la regie s'appliquera partout ou 
presque dans le document X M L ; il n'y a guere que la racine (qui est fille de rien^), les 
attributs et les domaines nominaux qui ne seront pas concernes par cette regie. 

On volt done que le motif le plus « ramasse-tout » que I'on puisse ecrire est compatible 
avec la contrainte des ancetres. 

Done, si on avait du souci a sefaire sur une diminution du pouvoir expressif d'un motif, 
a cause de I 'introduction de la contrainte des ancetres, ce serait pi utot du c6te d'une dimi- 
nution de pouvoir discriminant qu'il faudrait regarder. 



1. et comme telle, ne repond jamais quand on la traite de « child : : » 
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M ais en fait, il n'y a pas de probleme : meme s'il verifie la contrainte des ancetres, un 
motif peut rester tres di scri mi nant. 

Reprenons I'exemple deja vu pour illustrer le propos : 

<?xml version="1.0" encoding="UTF-8"?> 
<Sai son> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<The3tre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Prenons le motif Heure : il n'est pas tres discriminant, car trois elements differents 
concordent avec ce motif. M ais le motif concert/Date/Heure I'est beaucoup plus : un 
seul element du document X M L concorde avec ce motif. II est vrai que c'est parce qu'il 
n'y a qu'un seul concert dans le fichier, et que le motif Theatre/oate/Heure pourtant 
construit de la meme fafon, est un peu moins discriminant, avec deux elements concor- 
dants. 

M ais rien n'empeche, s'il le faut, de renforcer la discrimination en faisant intervenir un 
predicat. Un predicat, present dans I 'expression d'un motif, peut etre aussi complexe 
qu'on le veut, car sa complexity n'a aucune influence sur la localisation d'un noeud 
contexte adequat pour la recherche de concordance, localisation qui sera toujours limitee 
aux ancetres du noeud test. 

Le motif Theatre/oate/Heure evalue sur le noeud contexte <saison> donne en resultat 
un ensemble de deux noeuds : le noeud <Heure> 21H </Heure> et le noeud <Heure>2iH30 
</Heure>. Supposons que I'on veuille trouver un motif qui designe uniquement I'une de 
ces deux heures ; supposons de plus que I 'heure qui nous interesse soit celle du mer- 
credi ; on peut alors exprimer que c'est une <Heure> enfant d'une <Date> dont le texte 
(i.e. child: :text( )) est une chalne qui contient « M ercredi », cette <Date> etant elle- 
meme enfant de <Theatre>. 

Ce qui donne le motif : 

" Theatre/Date[contains(child: :text( ) , "Mercredi")]/Heure 

On volt done qu'il n'y a pas de souci a se faire sur les capacites discriminantes des 
motifs, meme s'ils respectent la contrainte des ancetres. 



Au cceur du langage XSLT 

Chapitre 3 



Syntaxe et contrainte pour un motif XSLT 

Le motif, ou pattern, fourni en tant que valeur de I'attribut match, s'exprime sous la 
forme d'une expression X Path detype Pattern LocationPatli, 

<xsl itempl ate match^". . .Pattern LocationPath. . . "> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :template> 

Un Pattern LocationPatli estun ensembledeclieminsde localisation separes pardes "|" 
(qui veulentdire« ou ») ; lesdifferentesetapesdechacun decescheminsde localisation 
doivent etre construites uniquement sur les axes child: : ou attribute: :, a I'exclusion 
detous les autres axes, 

En consequence, les abreviations "." et sont interdites dans un Pattern Loca- 
tionPath : "./True" n'est pas autorise, puisque c'est equivalent a "self: :node()/ 
child: :Truc", et que "self::" estinterdit; de meme, "../True" est interdit a cause de 

I'equivalenCeaveC "parent: :node()/child: :Truc". 

Bien que I'axe "descendant-or-seif : : " soit donc a ce titre interdit de sejour dans 
I'expression d'un motif, la version abregeede "/descendant-or-seif : :node( )/" sous la 
forme "//" est tout de memeautoriseeen tant que separateur d'etapes, a la place du "/". 
On remarquera que cette tolerance est compatible avec la contrainte des ancetres. 

Par contre, dans un predicat, aucun typed'axe de localisation n'est interdit. 

Notons pour finir que I'emploi de parentheses (autres que celles qui servent a certains 
determinants, comme texto, par exemple) est interdit dans un Pattern LocationPath, 
sauf bien stir dans les eventuels predicats. 

Exemples de motifs 

Nous allons maintenant voir quelques exemples de motifs (Pattern LocationPath), avec 
ou sans predicats. 

Remarque 

Donnerdes exemples de motifs n'auraitpas beaucoup de sens si on ne pouvaitrien faire d'autre d'un motif que 
de I'evaluer : il faudraitalors donnerachaque fois un document XML, un ncBud contexte, etun noeud test 
Mais au lieu dechercheraevaluerun motif, on peutse contenterde chercheraevaluerson pouvoir discriminant, 
etde voirce qu'il discrimine, dans I'absolu, en dehors de toute donnee XML. 

child: :chapit re/child: :sect ion/child: :paragraphe 

Forme courte : 

chapit re/section/pa rag raphe 

Concorde avec tous les noeuds de I'arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <chapitre> enfant du noeud contexte (quel qu'il soit). 
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child: ichapi tre/descendant-or-sel f : modeC )/chi Id: iparagraphe 



Forme courte : 
chapitreZ/paragraphe 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> enfants de 
noeuds qui sont des descendants (au sens large) de <chapitre> enfant du noeud contexte 
(quel qu'il soit). 

I chapitre/section | annexe 

Concorde avec tous les noeuds d'un arbre XML qui sont soit des <annexe>, soit des 
<section> elles-memes enfants de <chapitre>. 

child: :paragraphe/attribute: :al1gnement 

Forme courte : 
paragraphe/@al ignement 

Concorde avec tous les noeuds ai ignement d'un arbre XML qui sont des attributs de 
<paragraphe> enfant du noeud contexte (quel qu'il soit), 

I paragraphe/processing-instructionC ) 

Concorde avec tous les noeuds de type processing-instruction d'un arbre XML qui 

sont des enfants de <paragraphe>. 

I chap1tre/section/paragraphe[@al1gnement = "centre"] 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <chapitre>, a condition que les <paragraphe> pos- 

Sedent un attribut al ignement egal a "centre". 

Chi 1 d: : chapitre[foll owing-slbl ing: : annexe] /descendant-or- sel f: :node( )/ 
child: :paragraphe 

Forme courte : 

chap1tre[fol lowlng-sibling: : annexe] //pa rag raphe 

Concorde avec tous les noeuds d'un arbre XML qui sont des <paragraphe> descendants 
de <chapitre>, a Condition que ces chapitres soient suivis par une <annexe> au meme 
niveau hierarchique. Cette traduction estun peu libre, maisellerefletebien lasemantique 
decequ'on veutexprimer : on imagine un livreconstituede parties, elles-memes consti- 
tuees de chapitres qui se suivent, sur le meme plan hierarchique, le dernier chapitre d'une 
partie pouvant etre en fait une annexe (facultative). Pour un chapitre donne, les chapitres 
qui suivent (dans la meme partie) sont situes sur I'axe de localisation foiiowing- 

sibling, de SOrte que I'expreSSion child: :chapitre[following-sibling: :annexe] 

denote un ensemble de chapitres qui tous font partie d'une sehe termi nee par une annexe 
(au sein de la meme partie). Une regie possedant ce motif s'appliquera en definitive a 
tous les paragraphes d'une serie de chapitres d'une meme partie terminee par une 
annexe. Notons pour finir que rien, dans cette expression XPath, n'imposequ'uneeven- 
tuelle annexe soit le dernier element d'une serie de chapitres ; on pourraittres bien avoir 
une annexe en plein milieu d'une partie, avec des chapitres avant, et des chapitres apres. 
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Si c'etait le cas, seuls les chapitres situes avant pourraient concorder avec ce motif ; mais 
en pratique, il n'est pas courant devoir une annexe troner au milieu de cliapitres. 

child: :chapitre[position( ) = lastO] | child: : annexe 

Forme courte : 
chapitre[last( )] | annexe 

Concorde avec tous les noeuds de I'arbre XML qui sont des <annexe> ou bien des 
<chapitre>, acondition que ces chapitres soient en derniere position sur I 'axe de locali- 
sation child: :. En somme, si I'on reprend les explications du precedent ex emple, on volt 
que ce motif va concorder avec le dernier chapitre de chaque parti e, que ce chapitre soit 
un vrai chapitre ou qu'il soit en fait une annexe. 

Pour la fonction lasto, revoir la section Contexte devaluation d'un pre'dicat, page 57, 

Les motifs sont sensibles aux restrictions lexicales imposees par la notion d'attribut en 
XM L. Parexemple, lechemin XPath chapitre/sectionc positiono < 3 ] est correct. 

Pourtantil n'est pas possible d'en faireun motif a cause du caractere« <»qui estinterdit 
dans la chaine de caracteresformant la valeur d'un attribut. II n'y a malheureusement pas 
d'autre solution que d'ecrire quelque chose du genre : 

<xsl :templ ate select="chapitre/section[ positionO < 3 ]"> 

ce qui n'arrange guere la lisibilite de la chose. 



Priorities entre regies 

Algorithme de calcul des priorites par defaut 

II peutarriver, au coursdu processus detraitement(voirPrincipedefonctionnementd'un 
processeur XSLT, page 83), que plusieurs regies soient eligibles : pour chacune d'entre 
elles, le motif concorde avec le noeud en cours de traitement. U n algorithme de calcul de 
priorite par defaut est alors mis en oeuvre pour en selectionner une ; cet algorithme est 
assez complexedans le detail, mais grosso-modo, on peut direqu'entre deux regies dont 
I'une est plus specifique que I'autre, c'est a la plus specifique que la priorite la plus forte 
est aff ectee. 

Un cas tres courant ou cette notion de « plus specifique » s'applique defagon evidente, 
est celui d'une concurrence entre deux regies dont I'une utilise un joker ("*") : 

<xsl :templ ate match="Heure"> 

</xsl :templ ate> 

<xsl :templ ate match="*"> 

</xsl :templ ate>> 

En reprenantlefichierXML dejavu en Motifs (patterns), page 91 : 

' <?xml version="1.0" encoding="UTF-8"?> 
^ <Saison> 



Resume^H 

ChapitreW^M 

<Concert> <Organisation> Anacreon </Organisation> 

<Date>Saniedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapel 1 e des Ursules</Lieu> 

</Concert> 

<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

</Saison> 

on voitquesur n'importequel noeud <Heure> decefichier, les deux regies ci-dessus sont 
egalementapplicables. Neanmoins, "*" etant moins specifiqueque "Heure", c'est la pre- 
miere regie qui va I'emporter. 

Forgage de la priorite 

L'algorithmedecalcul des priorites par defaut etant assez fasti dieux a suivre, 11 est prefe- 
rable de ne pas s'y confronter, d'autant que c'est toujours possible. En effet, il existe un 
attri but priori ty qui permet d'affecter une priorite a une regie, ce qui permet de forcer la 
decision dans les cas ou I'on sent que I'on nemattriseplustres bien cequi va se passer : 

<xsl :templ ate niatch='Theatre//Heure' priority="2"> 
</xsl itempl ate> 

<xsl : tempi ate match^' Heure' priority=''l"> 
</xsl :teirpl ate> 

L'heure d'un concert sera prise en compte par la deuxieme regie, car pour un concert, le 
motif dela premiere neconcorde pas : pasd'ambiguite. Par contre I 'heure d'une piece de 
theatre peut etre prise en compte par les deux regies ; la priorite de 2 sur la premiere lui 
permet de I'emporter. 

A chaquefoisqu'un programmeXSLT contient des regies simultanementeligibles, il est 
detres loin preferable d'imposer les priorites que I'on souhaite, plutotquedese hasarder 
a finasser sur les priorites par defaut ou de tester ce que eel a donne avec tel ou tel proces- 
seur particulier, et d'en tirer des conclusions qui neseront peut-etre pas... concluantes. 

Resume 

N ous avons vu la forme generale d'une regie X SLT (voir Forme d 'une regie XSLT, page 79) : 

<xsl :template match="... motif (pattern) ..."> 
<!-- modele de transformation --> 



melange de texte et d'instructions XSLT du genre 
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<xsl :XXX ...> ... </xsl:XXX> 

<!-- fin du modele de transformation --> 
</xsl :teinplate> 

Puis nous avons vu le modele detraitement, qui expliquecequefait leprocesseur XSLT, 
et comment les regies X SLT interviennent dans ce processus. 

Enfin nous avons vu la notion de motif, etde concordance de motif, 

1 1 reste done encore a vol r I es di ff erentes i nstructi ons X S LT, i ntervenant dans I e corps des 
modeles de transformation, 

M ais avant cela, nous allons maintenant detainer les deux instructions fondamentales de 
XSLT, a savoir xsi:vaiue-of et xsi : appiy-tempi ates, Ces deux instructions sont 
importantes a comprendre en profondeur, parce qu'elles se completent tellement qu'on 
peut dire qu'a dies deux, elles forment le noyau dur des possibilites de transformations 
real i sables en XSLT, 



Note 

Certains auteurs parlentd'extraction individuelle {pull processing) pour <xsl:value-of>etde distribution selective 
{push processing) pour <xsl:apply-templates>, par reference a certains langages specialises dans le traitement 
et la manipulation de chaines de caracteres, comme awk sous Unix. Meme si I'on peut trouver que cette termi- 
nologie ne facilite pas vraimentia comprehension de la chose, il est tout de meme remarquable de voir que ce 
sont ces deux mots si complementaires (push etpull) qui ontprecisementetechoisis pourcaracteriseria nature 
de ces deux instructions. 

Instruction xsl:value-of 

Une regleXSLT utilisant instruction xsi :vaiue-of a d'ordinaire Talluresuivante : 

<xsl itempl ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 

melange de texte et 
d'instructlons XSLT de la forme : 

<xsl :value-of select="... chemin de localisation ..." /> 

<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Comme son nom I'indique, I'instruction <xsi ivaiue-of seiect=". . ." /> estremplacee 
lors de I'instanciation du modele par la valeur textuelle de ce qui est designe par I'attribut 
select, II s'agitdonc de la valeur textuelle (i,e, sous forme dechainede caracteres) d'un 
node- set, 

U n node-set comportant en general plusieurs noeuds source, sa valeur textuelle est defi- 
nie comme etant celle du noeud source qui arrive en premier dans I'ordre de lecture du 
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document. L'instruction est done finalement remplacee par la valeur textuelle d'un noeud, 
notion qui a ete definie a la section Module arborescent d'un document XML vu par 
XPath, page 30 etsuivantes. Quant au node-set en question, 11 resulte de I'evaluation du 
chemin de localisation fourni comme valeur de I'attribut select. Ce chemin de localisa- 
tion est calcule en prenant le noeud courant comme noeud contexte. 



Exemple 

Saison.xml 

<?xml version="1.0" encocling="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samecli 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl istylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforin" version = "1.0"> 
<xsl:output method='text' encoding='LITF-8'/> 

<xsl : tempi ate match='/'> 

Date Concert : <xsl :val ue-of select="Saison/Concert/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl itempl ate> 

</xsl :stylesheet> 

Cet exemple est d'un style assez contestable, car la regie XSLT indiquee presuppose 
qu'il y ait 1 element <concert> et 2 elements <Theatre> dans le fichier XML traite. 
Neanmoins, 11 est interessant parce qu'il ne requiert que des connaissances XSLT deja 
vues, pour etre analyse et compris. 

Appliqueeau fichier saison.xmi , cettefeuillede style produit le resultat suivant : 



Au cceur du langage XSLT 

Chapitre 3 



I Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

La declaration <xsi:oLitput method='text' encoding='UTF-8'/> permet de Specifier 
que I'on veut generer un resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit. Si I'on supprimait cette 
declaration, void le resultat que I'on obtiendrait : 

<?xml version="1.0" encoding="LITF-8"?> 



I Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XML genere automatique- 
ment, en contradiction avec la suite du fichier qui n'a pas du tout I'air d'un fichier XM L, 

Deroulement du processus de traitement sur cet exemple 

Cette section est a suivre en parallele avec la section M odele de traitement, page 87, 

Constitution d'une liste ne contenantque la racine 

C'est I'initialisation du traitement ; une liste est constitute, ne contenant que la racine, 
puis le traitement general de traitement des listes est lance (voir figure 3-12). 



Figure 3-12 

Constitution d'une 
liste ne contenant 
que ia racine. 




Traitement de cette liste 

Le traitement de cette liste se decompose en deux etapes : traitement dechaquenoeud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-13). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 

Traitement du nceud 

Dans notre exemple, il n'y a qu'uneseule regie, etson motif concordeavec le noeud cou- 
rant (c'est-a-dire la racine). La regie va done s'appliquer, ce qui veut dire que le modele 
de transformation associe va etre instancie (voir figure 3-14). 



Traitement 
(l)+(2) 



L iste a trailer 
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Document resultat 



DateConcert: Samedi 9 Octobre 1999 20H30 
Date Theatre: Mardi 19 Novembre 1999 21H 
Date Theatre: Mercredi 20 Novembre 1999 21H30 



root 



Traitement 
du nceud root 
(1) 



DateConcert: Samedi 90ctobrel999 20H30 
Date Theatre : M ardi 19 Novembre 1999 21H 
Date Theatre: Mercredi 20 IMovembre 1999 21H30 



Figure 3-13 

Traitement decetteliste. 



(2) 

Concatenation 
(non effective pour 1 seul element) 



Programme XSLT 



r> ^ concordance ^ , , , , , ^ ,„ 

root Q — ^<xsl:template match=/> 




Theatre 



leu 



Date Concert : <xsl:value-of select-' Sal son/Concert/Date7> 
DateTheatre : <xsl:value-of select="Saison/Theatre[l]/Date"/> 
DateTheatre : <xsl:value-of select="Saison/Theatre[2]/Date7> 



<xsl:template> 



Heure 



Instanciation 



DateConcert: Samedi 90ctobrel999 20H30 
DateTheatre : M ardi 19 Novembre 1999 21H 
DateTheatre: Mercredi 20 Novembre 1999 21H30 



Figure 3-14 

Traitement du no-ud. 
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Instanciation du modele 

Le modelede transformation est ici constitue d'un melange de textes ordinal res (comme 
par exemple « Date Concert : ») qui seront done recopies tels quels dans le fragment de 
document resultat, etd'instructions <xsi :vaiue-of>, qui seront done remplacees par leur 
valeur dans le fragment de document resultat (voir figure 3-15). 



M odele 



Date Concert : 



<xsl:value-of select="5aison/Concert/Date7> 



Date Theatre : 



<xsl:value-of select="5aison/Thcatre[l]/Date7> 



Date Theatre : 



<xsl:value-of select="5aison/Thcatre[2]/Date7> 



Figure 3-15 

Instanciation du modeie. 



recopie 
remplace par sa valeur 

recopie 

remplace par sa valeur 
recopie 



remplace par sa valeur 



Fragment de 
document resultat 



Date Concert : 



Samedi 9 0ctobrel999 20H30 



D ate T hcatre : 



Mardi 19 Novembre 1999 21H 



D ate T hcatre : 



Mercredi 20 Novembre 1999 21H30 



Valeur des differents node-sets 

Node-set "Saison/Concert/Date" 

Pour ['evaluation de cette expression XPath, le nceud contexte est root . La valeur d'un 
node-set est eel le de son premier element dans I 'ordre de lecture du document (vol r I nstruc- 
tion xsl:value-of, page 102) ; ici, I e node-set, calcule apartir du noeud contexte root , pos- 

Sede Un Seul element : <Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure></Date>. 

La valeur de cet element est egale au texte « Samedi 9 octobre 1999 » concatene a la 
valeur de I'element <Heure> 20h30 </Heure> (voir NcBud de type element, page 31) qui 
elle-meme est egale au texte « 20H30 ». Ce qui donne finalement « Samedi 9 octobre 
1999 20H30», 

Node-set "Saison/Theatre[l]/Date 

Pour revaluation de cette expression X Path, le nceud contexte est root . La valeur d'un 
node- set est eel le de son premier element dans I 'ordre de lecture du document (vol r I nstruc- 
tion xsl:value-of, page 102) ; ici, le node-set, calcule a partir du nceud contexte root , pos- 

Sede un seul element : <Date>Mardi 19 novembre 1999 <Heure> 21H </Heure></Date>. 

La valeur de cet element est egale au texte « M ardi 19 novembre 1999 » concatene a la 
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valeurderelement<Heure> 21H </Heure> </Date> (voir Na?ud de type element, page 31) 
qui elle-memeestegaleau texte« 21H ». Cequi donnefinalement« M ardi 19 novembre 
1999 21H ». 

Node-set "Saison/Theatre[2]/Date 

En suivant exactement le meme raisonnement, on obtient « M ercredi 20 novembre 1999 
21H30». 

Instruction xshapply-templates 

Une regie XSLT utilisant instruction xsi :appiy-tempiates a generalement la forme 
suivante : 

<xsl : tempi ate rtiatch="... motif (pattern) ..."> 
<!-- modele de transformation --> 
. . . texte . . . 
<xsl :apply-templates /> 
. . . texte . . . 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 

instruction <xsi :appiy-tempiates/> est remplacee par le fragment de document qui 
resulte du traitement de la liste des enfants du noeud courant. Le detail important, ici, est 
que cette liste, que nous avions deja evoquee (voir I nstanciation d 'un modele de transfor- 
mation relativement fl un nceud courant et une liste courante, page 90) est constitueedes 
elements enfants du nceud courant, pris dans I'ordre de lecture du document source. 

Exemple 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl rstylesheet 

xmlnsrxsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='LITF-8'/> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl itempl ate> 

<xsl itemplate match='Saison'> 

Manifestations au programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :templ ate> 
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<xsl :templ ate match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl itempl ate match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Appliquee au meme fichier Sanson. xmi que celui vu precedemment (voir Exemple, 
page 103), cettefeuille de style produit le resultat suivant : 

Manifestations au programme 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 



Theatre : 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 

Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Reservations 10 jours avant la date. 

Deroulement du processus de traitement sur cet exemple 

Cette section estasuivre en paralleleavec la section Modelede traitement, page 87. 

Constitution d'une liste ne contenantque la racine 

C'est I'initialisation du traitement ; une liste est constituee, ne contenant que la racine, 
puis le traitement general de traitement des listes est lance (voir figure 3-16). 

Traitement de cette liste 

Le traitement de cette liste se decompose en deux etapes : traitement dechaquenoeud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-17). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 
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Figure 3-16 

Constitution d 'une 
liste ne contenant 
que ia racine. 




Figure 3-17 

Traitement 
de cette iiste. 



T raitement 
(l)+(2) 



L Iste a traiter 



root 



Document resultat 



Concert : 
Pygmalion 

Same(li9 0ctobrel999 20H30 
ChapelledesUrsules 



Masqueset Lyres 

Mardi 19 Novembre 1999 21H 

SalledesCordeliers 



Traitement 
du noeud root 
(1) 



M anifestations au programme 



Concert : 
Pygmalion 

Samedl 9 Octobre 1999 20H30 
Chapelle des Ursules 



Theatre : 

M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 



Concatenation 
'non effective pour 1 seui eiement) 
(2) 



Theatre : 
Aristophane 

Mercredi 20 Novembre 1999 21H30 
SalledesCordeliers 



Reservations 10 jours avant la date. 
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Traitementdu nceud 

Dans notreexemple, il n'y a qu'uneseule regie, etson motif concorde avec le noeud cou- 
rant (c'est-a-dire la racine). La regie va done s'appliquer, cequi veut dire que le modele 
de transformation associe va etre instancie (voir figure 3-18). 



Programme XSLT 

I 'ordre des regies e'tant indifferent, 
; ia premiere a e'te' piace'e en dernier 

'• par commodite' 

<xsl:template match='Saison'> 

M anifestations au programme 
<xsi:appiy-tempiates/> 
Reservations 10 jours avant la date. 
</xsl:template> 



<xsl:tempiate match='Concert'> 

Concert : <xsi:vaiue-of seiect=".7> 
</xsi:tempiate> 



root 0< 



concordance 




Hajre 



<xsl:tempiate match='Theatre'> 

Theatre : <xsi:vaiue-of select= 
</xsi:tempiate> 

<xsl:template match='/'> 
[ <xsl:apply-templates/> 
</xsi:template> 



"/> 



Instanciation 



M anifestations au programme 

Concert : 
Pygmalion 

Samedi 9 Octobre 1999 20H30 
ChapelledesUrsulea 



Theatre : 

Masques et Lyres 
Mardil9Novembrel999 21H 
Salle desCordeliers 



Reservations 10 jours avant la date. 



Figure 3-18 

Traitement du na?ud. 



Instanciation du modele de transformation 

Le modele a instancier comportant une instruction <xsi :appiy-tempiates>, celle-ci est 
remplacee par sa valeur, resultant du traitement d'une nouvelle liste de noeuds. Cette nou- 
velle liste est constituee en rassemblant tous les noeuds enfants du noeud courant. Ici, 
comme le noeud courant est root , il n'y a qu'un seul enfant, qui est le noeud <Saison> 
(voir figure 3-19). 
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M odele 



<xsl:apply-templates/> 



G enerat 
nouve 
( 


on d'une 
le liste 

L) 







L iste a traiter 



Saison 



Traitement 
du nceud 
Saison 
(2) 



M anifestationsau programme 



Concert : 
Pygmalion 

Samedi 9 Octobrel999 2OH30 
Ctiapeiiedes U rsuies 



Theatre : 

M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Saiiedes Cordeiiers 



Theatre : 
A ritophane 



Reservations 10 jours avant la di 



Fragment de 
document resultat 



remplace par sa valeur 
{l)+(2)+(3) 



Traitement 

(2) +(3) 



Masques EtLyres 

Mardi 19 Novembre 1999 21H 

Salle dsCordeliers 



A ri staph arte 

M etcredi 20 N ovembre 1999 21H 30 
Salle desCordeliers 



Concatenation 
(non effective pour 1 seui eiement) 
(3) 



Figure 3-19 

Instanciation du modele de transformation. 
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Traitementdu nceud <Saison> 

Le noeud <Saison> eSt le noeud COUrant; la regie <xsl : tempi ate match='Saison'> 

Concorde avec ce noeud, elle est done appliquee (voir figure 3-20). Son application se tra- 
duit par I'instanciation du modele de transformation associe. 



root 



Theatre 




concordance 



lOI 



Heure 



Programme XSLT 

I 'ordre des regies e'tant indifferent, 
ia regie se'iectionne'e a e'te' piace'e en 
dernier par commodite' 

<xsi:tempiate matcli='/'> 

<xsi:appiy-tempiates/> 
</x5l:tempiate> 

<xsi:tempiate matcli='Concert'> 

Concert : <xsi:vaiue-of seiect="."/> 
</xsi:template> 

<xsi:tempiate matcli='Tlieatre'> 

Tiieatre : <xsi:vaiue-of select-'. "/> 
</xsi:tempiate> 

<xsi:tempiate matcli='Saison'> 



M anifestations au programme 
<xsi:appiy-tempiates/> 
Reservations 10 jours avant ia date. 



</xsi:template> 



Instanciation 



M anifestations aj prograrrm 



Concert : 
Pygmalion 

Samedt9 0ctobrel999 ZOH30 
ChapelledesUrsjIes 

Theatre: 

Masques etLyres 

Mardi 19 fJovenibre 1999 21H 

Salle des Cordeliers 



Theatre: 

Mercredi 20 Novemhre 1999 21H30 
Salle des Cordeliers 



Reservations 10 jours avant la date. 



Figure 3-20 

Traitementdu naud <Sai5on>. 



Instanciation du modele de transformation 

Le modele a instancier comporte d'une part du texte ordinaire qui est done recopie dans 
le fragment de document resultat, et d'autre part une instruction <xsi :appiy-tempi ates>. 
Elle est remplacee par sa valeur, qui resulte du traitement d'une nouvelle liste de noeuds 
comportant I'ensemble des noeuds enfants du noeud courant, c'est-a-dire I'element 
<Saison> (voir figure 3-21), 



M odele 
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Fragment de 
document resultat 



M anifestations au programme 



recopie 



<xsl:apply-templates/> 



ran|]lace par sa valeur 



)+(2)+(3)+(4)+(5) 



Reservations 10 jours avant la date. 



Generaton d'une 
nouvdie liste 
(1) 



L iste a traiter 



Concert 



Theatre 



Traitement 
du noeud 
Concert 
(2) 



Traitement 
du ncEud 
Theatre 
(3) 



Traitement 
{2)+(3)+(4)+(5) 



recopie 



Theatre 



Traitement 
du noeud 
Theatre 
(4) 



Concert : 
Pygmalion 

Samedi SOctobre 1999 2OH30 
Chapeiiedes U rsuies 



T heatre : 

M asques et Lyres 

Mardi 19 Novembrel999 21H 

Salts des Cordeliers 



Theatre : 
Aristophane 

Mercredi 20No\/embrel999 Z1H30 
Salle des Cordeliers 



- M anifestations au programme 



Pygmaiion 

Samedi 9 Octobre 1999 20H30 
CtiapelledsUriuis 



SailedesCotdelier 



A tistopliane 

M ercredi 20 Novembre 1999 Z1H3C 
SalledesCordeiiers 



- ^ Reservations 10 jours avant la date. 



Concatenation 
(5) 



Figure 3-21 

Instanciation du modelede transformation. 
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II y a done desormais trois traitements separes a effectuer (qui pourraient, dans I'ideal, 
etre realises simultanement sur trois processeurs matehels differents), un pour le noeud 
<concert>, un pour le premier noeud <Theatre>, et un pour le deuxieme noeud <Theatre>. 

Premiere branche du traitement (noeud <Concert>) 

Traitement du noeud <Concert> 

Le noeud <Concert> eSt le noeud COUrant; la regie <xsl :template match='Concert'> 

Concorde avec ce noeud, elle est done appliquee (voir figure 3-22), Son application setra- 
duit par I'instanciation du modele de transformation associe, 



Programme XSLT 

I 'ordre des regies e'tant indifferent, 
ia regie se'iectionne'e a ete' piace'e en 
dernier par commodite' 

<xsl:tempiate matcli='/'> 

<xsi:appiy-tempiates/> 
</xsi:tempiate> 



<xsi:tempiate matcli='Saison'> 

M anifestations au programme 
<xsi:appiy-tempiates/> 
Reservations 10 jours avant ia date. 

</xsi:template> 



root % 




concordance 



Theatre 



<xsl:tempiate matcli='Tiieatre'> 

Tiieatre : <xsi:vaiue-of select-'. "/> 
</xsi:tempiate> 

<xsl:tempiate matcli='Concert'> 

Concert : <xsi:vaiue-of seiect=".7> 



Heure 




Lieu 



</xsi:template> 



Instanciation 



Concert : 
Pygmaiion 

Samedi 9 0ctobrel999 20H30 
Ciiapeiiedes Ursuies 



Figure 3-22 

Traitement du na?ud <Concert>, 
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Instanciation du modele de transformation 

L e modele de transformation contient du texte neutre (recopie dans I e fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des diff<?rents node- 
sets, page 106. La figure 3-23 montred'une part I 'instanciation du modele, etd'autre part 
les etapes du calcul de la valeur du node-set reduit au seul element <concert>. 



M odele 



Concert : 



<xsl:value-of select=".7> 



recopie 



Fragment de 
document resultat 



Concert: 



remplace par sa valeur 



Pygmalion 

Samedi 9 0ctobrel999 20H30 
Chapelle des Ursules 



element 

Organisation 



_ text _ 

Pygmalion 



text 



Samedi 9 
Octobrel999 



element 

Concert 



element 

Date 



element 

Heure 



. text . 

20H30 



element 

Lieu 

- text - 



Chapelle des 
U rsules 



valeur( <Concert> ) = 
concatenation! 

valeurl <Organisation> ) + 
valeurf <Date>) + 
valeur( <Lieu>) 

) 

valeur( <Organisation>) =""Pygmalion" 

valeur( <Date> ) = 

"Samedi 9 Octobrel999" + 
valeur( <Heure> ) 

valeurl <Lieu>) ="ChapelledesUrsules" 

valeur( <Heure>) ="20H30" 



Figure 3-23 

I nstanciation du modele de transformation. 
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Deuxieme branche du traitement (nceud <^heatre>) 

Traitement du premier noeud <Theatre> 

Le premier noeud <Theatre> est le noeud COUrant ; la regie <xsl :template match='Thea- 

tre'> Concorde avec ce noeud, die est done appiiquee (voir figure 3-24), Son application 
se traduit par i'instanciation du modeiede transformation associe, 



Programme XSLT 

I 'ordre des regies e'tant indifff'rent, 
la regie se'lectionne'e a etc' place'e en 
dernier par commoditc 

<xsl:template match=7'> 

<xsl:apply-templates/> 
<xsl:template> 

<xsl:template match='Saison'> 

M anifestatlons au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 



1 



Instanciation 

t 

Theatre : 

M asques et Lyres 

MardI 19 Novembrel999 21H 

Salle des Cordeliers 



Figure 3-24 

Traitement du premier naud <Theatre>. 



root 




concordance 



Theatre 



leu 



<xsl:template match='Concert'> 

Concert : <xsl:value-of select-'. "/= 
</xsl:template> 

<xsl:template match='Theatre'> 

Theatre : <xsl:value-of select-'. "/> 
</xsl:template> 



Heure 



Instanciation du modele de transformation 

Le modeiede transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des diffe'rents node- 
sets, page 106. La figure 3-25 montred'une part I 'instanciation du modele, etd'autre part 
lesetapesdu calcul de la valeur du node-set reduitau seul element <Theatre> (le premier 
des deux). 
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Fragment de 

M odele document resultat 







recopie 










Theatre : 






Theatre : 




remplace par sa valeur 


- 






M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salle des Cordeliers 






<xsl:value-of select=".7> 








- 







element 

I Organisation J 



_ text _ 

M asques et 
Lyres 



text 



M ardi 19 
Novembre 1999 



element 

Theatre 



element 

Date 



element 

Heure 



text 

21H 



element 

Lieu 

_ text _ 

Salle des 
Cordeliers 



valeur{ <Theatre>) = 
concatenation! 

valeur( <Organisation>) + 
vaieurj <Date>) + 
vaieurj <Lieu> ) 



valeur( <OiganisaSon> ) = "M asques et Lyres" 

valeur( <Date> ) = 

"Mardi 19 Novembre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) = "Salle des Cordeliers" 

valeur( <Heure>) ="21H" 



Figure 3-25 

Instanciation du modele de transformation. 



Troisieme branche du traitement (nceud <Theatre>) 

Traitement du deuxieme noeud <Theatre> 

Le deuxieme noeud <Theatre> est le noeud courant; la meme regie <xsi :tempiate 
match= ' Theatre ■> Concorde avec ce noeud, elleestdonc a nouveau appliquee (voir figure 
3-26). Son application se traduitpar I'instanciation du model ede transformation associe. 
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root 




Programme XSLT 

I 'ordre des regies e'tant indifff'rent, 
la regie se'lectionne'e a e'te place'e en 
dernier par commodltc' 

<xsl:template match='/'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match='Salson'> 

M anifestatlons au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

<xsl:template> 

<xsl:template match='Concert'> 

Concert : <xsl:value-of select-'. "/> 
</xsl :templ ate> 



concordance . ,^ 

— ^ <xsl:template match-Theatre 



leu 



Theatre : <xsl:value-of select-'. "/> 



Heure 



<xsl;template> 



Instanciation 



Figure 3-26 

Traitementdu deuxieme na?ud <Theatre>. 



T heatre : 
Arlstophane 

Mercredl 20 Novembre 1999 21H30 
Salle des Cordeliers 



Instanciation du modele de transformation 

Le modele de transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des diffe'rents node- 
sets, page 106. La figure 3-27 montred'une part I 'instanciation du modele, etd'autre part 
les etapes du calcul de la valeur du node-set reduit au seul element <Theatre> (le 
deuxieme). 

Synthese de ces trois traitements independants 

Les fragments de documents obtenus lors des instanciations de modeles (figures 3-27, 
3-25, 3-23) sont concatenes (voir etape (5) de la figure 3-21), ce qui donne la forme 
definitive du document resultat, que I 'on retrouve ensuite inchange lorsqu'on remonte 
depuis la figure 3-21 jusqu'a la figure 3-17 . 
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M odele 



Theatre : 



<xsl:value-of select=".7> 



recopie 



remplace par sa valeur 



Fragment de 
document resultat 



*- Theatre : 



Aristophane 

M ercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 



element 

I Organisation J 



text 

Aristophane 



text 



M ercredi 20 
Novembre 1999 



element 

Theatre 



element 

Date 



element 

Heure 



. text . 

21H30 



element 

Lieu 

_ text _ 

Saiie des 
Cordeiiers 



valeur{ <Theatre>) = 
concatenation! 

vaieur( <Organisation>) + 
vaieurj <Date>) + 
vaieuri <Lieu> ) 



vaieur( <OiganisaSon> ) = "Aristophane" 

vaieur( <Date> ) = 

"M ercredi 20 Novembre 1999" + 
vaieur( <Heure>) 

vaieur( <Lieu>) = "Saiie des Cordeiiers" 

vaieur( <Heure>) ="21H30" 



Figure 3-27 

instanciation du modele de transformation. 



Regies par defaut 

II peutarriver quelorsdu traitementd'un noeud, aucune regie fournie dans le programme 
XSLT nesoit applicable, caraucun motif neconcordeavec le noeud courant. Danscecas, 
une regie par defaut est appliquee, qui depend de la nature du noeud a traiter. 

Et comme par hasard, les regies par defaut, que nous allons maintenant voir, n'utilisent 

que leS deux instructions xsl :value-of etxsl :apply-templates. 
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Regies par defaut pour la racine d'un arbre XML ou un element 

La regie par defaut instancie un fragment de document en reportant le traitement sur les 
enfants du noeud courant. 

Elles'exprimedonc ainsi : 

<xsl :templ ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 



Remarque 

Une regie par defaut n'est jamais en conflit avec une regie explicite. II ne faut pas imaginer qu'une regie par 
defaut comme celle montree ci-dessus se comporte comme si elle etaitautomatiquementincorporee ala feuille 
de style par le processeur XSLT. Une regie par defaut reste interne au processeur; elle n'est activee que si 
aucune regie, dans la feuille de style, n'est applicable. Si dans votre feuille de style, vous avez une regie 
<xsi itempiate match='*'> ... </xsi : tempi ate>, elle n'entrera jamais en conflitavec la regie par defaut, 
car la regie par defaut sera ignoree. 

Ce qui estditici estbien survalable pourles autres regies par defaut decrites ci-dessous, 



Regies par defaut pour un ncBud de type text ou attribute 

La regie par defaut instancie un fragment de document en prelevant la valeur du noeud 
courant. 

Elles'exprimedonc ainsi : 

<xsl :template match='text( ) jattribute: :*'> 

<xsl :val ue-of select = "." /> 
</xsl :templ ate> 

Regies par defaut pour un noeud de type comment 
ou processing-instruction 

La regie par defaut instancie un fragment de document vide, 

Elles'exprimedonc ainsi : 

f <xsl :template match='cominent( ) | processing-instructionC ) '> 
</xsl itempl ate> 

Exemples 

Nous conservons toujours le meme exemple de fichier XML a traiter; aucune regie 
expl icite n'est cette fois fournie dans le programme X SLT : 

|<?xml version="1.0" encoding="LITF-8"?> 
<xsl :stylesheet 
xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.0"> 
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<xsl:output method='text' encocling='LITF-8'/> 
</xsl :stylesheet> 

Le resultat obtenu est alors le suivant : 

Anacreon 

Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 



Masques et Lyres 
Mardi 19 novembre 1999 21H 

Salle des Cordeliers 



Masques et Lyres 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 

Ce resultat s'interprete ainsi : la racine de I'arbreXM L du document est traitee ; aucune 
regie ne s'applique (et pour cause), la regie par defaut 

<xsl : tempi ate match='/|*'> 
<xsl :apply-teinplates/> 
</xsl :templ ate> 

est done appliquee, cequi entraineletraitementdu noeud racine du document! <saison>). 
A ucune regie ne s'applique a ce noeud, la regie par defaut 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl itempl ate> 

S'applique done a nouveau, ce qui entraine le traitement des noeuds <concert>, <Theatre>, 
<Theatre>. A ucune regie ne s'applique au noeud <concert>, la regie par defaut 

<xsl :template match='/|*'> 
<xsl :apply-teinplates/> 
</xsl :templ ate> 

S'applique done a nouveau, ce qui entratne le traitement des noeuds <organisation>, 

<Date>, <Lieu>. 

Aucune regie ne s'applique au noeud <organisation>, la regie par defaut 

|<xsl :template match='/|*'> 
<xs1 :apply-teinplates/> 
</xsl itempl ate> 
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s'applique done a nouveau, ce qui entralne le traitement du noeud text enfant de 

<Organi sati on>. 

Aucune regie ne s'applique a ce noeud texte, la regie par defaut 

k <xsl :templ ate match^'textO |attribute: :*'> 
I <xsl :val ue-of select = "." /> 

I </xsl :templ ate> 

S'applique done, cequi entraine I'instanciation du fragment de document Anacreon. 

II en va de meme pour les autres elements du document XML: tous les elements sont 
traites par la regie 

<xsl:template match='/|*'> 
i <xsl :apply-teniplates/> 
I </xsl :templ ate> 

ettous les noeuds text sont traites par la regie 

<xsl itemplate match='text( ) |attribute: :*'> 
<xsl :val ue-of select = "." /> 
^ </xsl :templ ate> 

ce qui finit par produire un document identique au document XML original, prive de 
toutesses balises. 

Le premier exemple que nous avons vu (voir Exemple, page 103) 

Saison.xsl 

<?xml version="1.0" encoding="LITF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 
<xsl:output method^'text' encoding='UTF-8'/> 

<xsl itempl ate match='/'> 

Date Concert : <xsl :val ue-of sel ect="Sai son/Concert/Date"/> 

Date Theatre : <xsl :val ue-of sel ect="Sai son/Theatre[l]/Date"/> 

Date Theatre : <xsl :val ue-of sel ect="Sai son/Theatre[2]/Date"/> 

</xsl :templ ate> 

</xsl :stylesheet> 

pourrait etre reecrit dans un style beaucoup plus correct, en utilisant les regies par 
defaut : 

Saison.xsl 

<?xirl version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforni" 

version = "1.0"> 
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<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl : tempi ate match^' Concert '> 

Date Concert : <xsl :val ue-of sel ect="Date"/> 
</xsl itempl ate> 

<xsl : tempi ate match='Theatre'> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 
</xsl itempl ate> 

</xsl :stylesheet> 

et on obtiendrait a nouveau : 

Date Concert : Samedi 9 octobre 1999 20H30 



Comportement inattendu d'un programme XSLT 

La presence de ces regies implicites induisent parfois des comportements apparemment 
bizarresdelapartdu processeurXSLT, lorsquele source XSLT comporte uneerreur. Par 
exemple, introduisons une fautedefrappe dans la balise <Theatre> , en oubliant I 'accent 
circonflexe sur le « a », comme ceci : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl :template match='Concert'> 

Date Concert : <xsl :val ue-of sel ect="Date"/> 
</xsl :templ ate> 

<xsl :template match='Theatre'> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 
</xsl itempl ate> 

</xsl :stylesheet> 

Le resultat n'a alors plus rien avoir avec cequ'on souhaite : 

I Date Concert : Samedi 9 octobre 1999 20H30 



Date Theatre 



Mardi 19 novembre 1999 21H 



Date Theatre 



Mercredi 20 novembre 1999 21H30 
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Masques et Lyres 
Mardi 19 novembre 1999 21H 

Salle des Cordeliers 



Masques et Lyres 
Mercredi 20 novembre 1999 21H30 

Salle des Cordeliers 

Le resultat obtenu etant plus volumineux que ce qu'on attendait, c'est done que des 
regies par defaut ont ete mises en oeuvre. 

Pour savoir exactement ce qui se passe, on peut incorporer au programme XSLT une 
regie « attrape-tout » : 

<xsl rtempl ate match='*'> 

erreur : element non prevu : tag( <xsl : val ue-of sel ect="l ocal -name( . )" /> } 
<xsl :apply-templates/> 
</xsl :templ ate> 

local -nameo est une fonction qui renvoie le nom de I'element fourni en argument 
(ici « . », c'est-a-dire I'element courant). 

Le processeur X SLT applique cette regie de preference a la regie par defaut, 

<xsl :templ ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 

parce qu'une regie par defaut est par definition choisie quand aucune autre, fournie expli- 
citement, ne convient, Void alors le resultat obtenu : 

erreur : element non prevu : tag{ Saison } 
Date Concert : Samedi 9 octobre 1999 20H30 

erreur : element non prevu : tag{ Theatre } 

erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date } 
Mardi 19 novembre 1999 
erreur : element non prevu : tag{ Heure } 
21H 

erreur : element non prevu : tag{ Lieu } 
Salle des Cordeliers 



erreur : element non prevu 



tag{ Theatre } 
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erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date ) 
Mercredi 20 novembre 1999 
erreur : element non prevu : tag{ Heure } 
21H30 

erreur : element non prevu : tag{ Lieu } 
Salle des Cordeliers 

Tous ces messages d'erreur sont coherents avec ce qu'on attend du programme XSLT, 
sauf celui concernant le tag Theatre puisque precisement notre programme est cense 
traitercet element en lui appliquantune regie explicite. L'element <Theatre> n'etant pas 
reconnu par le motif de cette regie, la cause de I'erreur est done maintenant facile a trouver. 



Conclusion 

Nous venons de voir la structure generale d'un programme XSLT, constitue de regies, 
avec leur motifs et leurs modeles de transformation. Une regie s'applique a un noeud si 
son motif Concorde avec le noeud ; danscecas le model ede transformation est instancie, 
et nous avons vu les deux instructions les plus representatives qui entrent en jeu lors de 

ces instanciations, xsl : val ue-of, et xsl :apply-templ ates. 

Nous allons maintenant voir plus en detail les instructions disponibles en XSLT, en les 
classant par grandes categories : les instructions de transformation (comme xsl : val ue- 
of et xsl :appiy-tempiates), les instructions de programmation, comme xsi:if, ou 

xsl : variable, et deS instructions de creation, comme xsl : element, ou xsl : attribute. 

Comme toute classification, celle-ci est bien sur contestable, car il suffit de prendre un 
autre point de vue pour en obteni r une autre completement differente , ou pour se rendre 
compte que final ement, telle instruction classee dans les instructions de programmation 
auraitaussi bien pu etre classee dans les instructions de transformation. II nefautdonc 
pas y voir autre cliose qu'un moyen commode pour amener les notions progressivement. 
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Les instructions 
de transformation 



Ce chapitre a pour but de faire decouvrir les instructions de transformation du langage 
XSLT, et d'en montrer le fonctionnement. L'exliaustivite propre a un manuel de refe- 
rence n'est pas recliercliee ici, et tout ce qui aurait pu etre de nature a perturber la 
comprehension au point ou I'on en est dans la lecturede I'ouvragea ete elimine. 

Une annexe (voir R«?f«?rence des instructions XSLT, page 623) reprendra la liste generale 
detoutes les instructions, avec cette fois I'integralite des attributs, de leurs proprietes, et 
deleurs valeurs possibles. 

A tout seigneur, touthonneur : nous commencerons done par I'instruction xsi : tempi ate 
qui definit une transformation. Ensuite, nous verrons les deux instructions de base, 

xsl :value-of, et xsl : apply-templ ates. NoUS poursuivrons aveC xsl :for-each, la COU- 

sinedexsi :appiy-tempiates. Puisviendra leurassociee, xsi :sort. Enfin, noustermine- 
rons par I'instruction xsi :copy-of, cousinedexsi :vaiue-of. 

Peut-etre n'est-il pas inutile d'expliquer pourquoi classer ces instructions dans la catego- 
rie des instructions de transformation. A pres tout, XSLT veut dire XSL Transformations, 
done toute instruction de ce langage pourrait valablement etre qualifiee d'instruction de 
transformation, 

Cependant, ce qui fait reellement I'originalite et la puissance de XSLT, c'est son mo- 
dele de traitement (voir M odele de traitement, page 87). Et ce modele de traitement est 
congu pour fonctionner en faisant appel aux instructions xsi :vai ue-of et xsi :appiy- 
tempiates, sans lesquelles 11 n'est plus rien ; et reciproquement, ces instructions sont 
inutiles et inoperantes sans le modele de traitement. Les autres instructions listees ci- 
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dessus sont de la meme veine, et participent aussi a la mise en oeuvre du modele de trai- 
tement, tout en etant deja moins indispensables. 

Cequ'il fautdonc retenir, c'est que ce que nous appelons instruction de transformation, 
ce n'est pas une instruction effectuant en elle-meme une transformation quelconque, 
mais une instruction integree au coeurdu modele de transformation. 

Les autres instructions, que nous avons classees dans les categories d' instructions de pro- 
grammation ou de creation, pourraient tres bien etre supprimees du langage XSLT sans 
que cela casse le modele de traitement, qui conserverait toute la puissance de son prin- 
cipe. Ces instructions apportent des facilites complementaires, et augmentent chacune a 
leur maniere le champ d'application du langage, mais sans rien apporter de fondamenta- 
lement nouveau au model e de traitement, qui a I a I i mi te, peut se contenter de I ' i nstructi on 

xsl :template, et deS deUX instructions xsl:value-of et xsl :apply-templates pOUr 

fonctionner, 



Instruction xshtemplate 

Cette instruction a deja ete largement detaillee a I'occasion de la description de I'instruc- 
tion xsl :vaiue-of (voir InstructioH xsl;value-of, page 102) : nous nous contenterons de 
rappeler les elements essentiels et les variantes syntaxiques. 

Syntaxe 

xsl : tempi ate 

<xsl :templ ate match="... motif ..." /> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 

instruction xsi rtempiate doit apparattre uniquement comme instruction de premier 
niveau. 

Semantique 

Cette instruction, qui definit une regie, estau coeurdu fonctionnementdu langage XSLT ; 
on se reportera aux sections M odele de traitement, page 87, M otifs (patterns), page 91 et 
Priorites entre regies, page 100. 

Instruction xsl:value-of 

Cette instruction a deja ete largement detaillee (voir Instruction xsl:value-of, page 102) : 
nous nous contenterons d'en indiquer les elements essentiels et les variantes syntaxiques. 



Instruction xsl:value-of H 

Syntaxe 

xsl : val ue-of 

I <xsl :val ue-of select^"... chemin de localisation ..." /> 

L'instruction xsi:vaiue-of ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Le cliemin de localisation fourni comme valeur de I'attribut sei ect n'est pas limite a cer- 
taines formes comme c'est le cas pour le motif (voir Syntaxe et contrainte pour un motif 
XSLT, page 98) ; toute la puissance expressive du langageXPath est ici utilisable. 

Regie XSLT typique 

Une regie XSLT utilisant instruction xsi :vai ue-of va typiquement avoir la forme : 

<xsl :templ ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 

melange de texte et 

d' instructions XSLT de la forme : 

<xsl :val ue-of select^"... chemin de localisation ..." /> 



<!-- fin du modele de transformation --> 
</xsl :templ ate> 

Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le noeud 
courant (le noeud en cours detraitement). C'est ce noeud qui fait office de noeud contexte 
dans I 'evaluation du chemin de localisation fourni comme valeur de I'attribut select. 

Comme son nom I'indique, l'instruction <xsi :vai ue-of seiect=" ..." /> est remplacee 
lors de I 'instanciation du modele par la valeur textuel le de ce qui est designe par I 'attribut 
select. II s'agitdonc de la valeur textuelle (i.e. sous forme de chaine de caracteres) d'un 
node-set, ou d'un booleen, ou d'un nombre, ou d'une chaine de caracteres, suivant la 
valeur renvoyee lors de devaluation du chemin de localisation. 

Un booleen ou un nombre est converti en chaine de caracteres par appel de la fonction 

stri ng( ) , 

U n node-set comportant en general plusieurs noeuds source, sa valeur textuelle est definie 
comme etantcelledu noeud source qui arrive en premier dans I'ordrede lecture du docu- 
ment. L'instruction est done final ement remplacee par la valeur textuelle d'un noeud (un 
seul), notion qui aete definie a la section M odele arborescent d'un document XM L vu par 
XPath, page 30 et suivantes. 
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Exemple 



Saison.xml 

<?xml version="1.0" encoding="LITF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Llrsules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="LITF-8"?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 
<xs1:output inethod='text' encoding='UTF-8'/> 

<xsl itempl ate match='/'> 

Date Concert : <xsl :val ue-of sel ect="Sai son/Concert/Date"/> 
Date Theatre : <xsl :val ue-of sel ect="Sai son/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of sel ect="Sai son/Theatre[2]/Date"/> 

</xsl :templ ate> 

</xsl :stylesheet> 

Appliqueeau fichier saison.xmi , cettefeuillede style produit le resultat suivant : 



La declaration <xsi:output method='text' encoding='UTF-8'/> permet de Specifier 
que I'on veut generer un resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit, Si I'on supprimait cette 
declaration, void le resultat que I'on obtiendrait : 

<?xml version="1.0" encoding="LITF-8"?> 



Date Concert 
Date Theatre 
Date Theatre 



Samedi 9 octobre 1999 20H30 
Mardi 19 novembre 1999 21H 
Mercredi 20 novembre 1999 21H30 



Date Concert 



Samedi 9 octobre 1999 20H30 
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■Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XM L genere automatique- 
ment, en contradiction avec la suite du ficliier qui n'a pas du tout I'air d'un ficliier XML. 



Variante syntaxique 

On peut si Ton veut ajouter un attribut disabie-output-escaping a I'element 
xsi :vaiue-of, commececi : 

I <xsl :val ue-of select^"..." disable-OLitput-escaping="yes|no" /> 

Get attribut vaut no par defaut, ce qui veut dire que les caracteres speciaux pour XML 
(comme< ou > ) sontsortis sous forme d'entites caracteres (&it; ou &gt:), 



Instruction xshapply-templates 

Cette instruction a deja ete largement detaillee (voir Instruction xsl:apply-templates, 
page 107) : nous nous contenterons d'en indiquer les elements essentiels et les variantes 
syntaxiques. 

Syntaxe 

I <xsl lapply-templates /> 

L'instruction xsi :appiy-tempiates ne doit pas apparattre en tant qu'instruction de pre- 
mier niveau. 

Regie XSLT typique 

Une regie XSLT utilisant instruction xsi :appiy-tempiates aura souvent la forme : 

<xsl : tempi ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
. . . texte . . . 
<xsl :apply-templates /> 
. . . texte . . . 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 



Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le noeud 
courant (le noeud en cours de traitement) ; instruction <xsi :appiy-tempiates/> est 
remplacee par le fragment de document qui resulte du traitement de la liste des enfants du 
noeud courant. Le detail important, ici, est que cette liste, que nous avions deja evoquee 
(voir Instanciation d'un module de transformation relativementa un n^ud courant et une 
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liste courante, page 90) est constituee avec les elements enfants du noeud courant, pris 
dans I 'ordre de lecture du document source. 



Exemple 

Saison.xsl 

, <?xml version="1.0" encoding="LITF-8"?> 
<xsl rstylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transforni" 
version = "1.0"> 

<xsl:output method^'text' encoding='UTF-8'/> 

<xsl itempl ate match='/'> 

<xsl :apply-teniplates/> 
</xsl :templ ate> 

<xsl itempl ate match='Saison'> 

Manifestations au programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :template> 

<xsl itempl ate match='Concert'> 

Concert i <xsl ival ue-of select="."/> 
</xsl itempl ate> 

<xsl itempl ate match='Theatre'> 

Theatre i <xsl :value-of select="."/> 
</xsl itempl ate> 

</xsl istylesheet> 

Appliquee au meme fichier Sanson. xmi que celui vu precedemment (voir Exemple, 
page 130), cette feuille de style produit le resultat suivant : 

Manifestations au programme 



Concert i 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 



Theatre i 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 
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Theatre : 

Aristophane 

Mercredi 20 novembre 1999 
Salle des Cordeliers 



21H30 



Reservations 10 jours avant la date. 

Variante syntaxique select="..." 

On peut si I'on veut ajouter un attribut select a I'element appiy-tempiates , comme 
ceci : 

I <xsl lapply-templates select^"... chemin de localisation ..." /> 

L'effet de I'attribut sei ect est de modifier la constitution de la nouvelle liste de noeuds a 
traiter : en I'absence de seiect=". . .", cette liste contient tous les enfants directs du 
noeud courant ; mais si I'attribut select est fourni, sa valeur (un chemin de localisation) 
estcalculee, cequi donneun node-set, et les elements dece node-set, prisdansl'ordrede 
lecture du document X M L, vont alors constituer la nouvelle liste de noeuds a traiter. 

En principe, le chemin de localisation que I'on fournit pour I'attribut select fait partie 
des descendants du noeud courant, meme si la specification du langageXSLT n'impose 
pas cette contrainte. En tous cas, c'est une bonne pratique que de se limiter a ce genre de 
node-set. Si I'on transgresse cette regie debon sens, on risque d'introduire une recursion 
infinie dans le fonctionnement du processeur X SLT : 

<xsl : tempi ate match='truc'> 

<xsl :apply-teniplates select=". "/> 

</xsl itempl ate> 

Ici, on impose au processeur X SLT une recursion infinie, puisque I'attribut select selec- 
tionne le noeud courant lui-meme, qui va done indefiniment concorder avec le motif de 
cette regie, indefiniment reactivee. 

Dans I'exemple que nous venons de voir (voir Exemple, page 132), on pourrait vouloir 
faire apparaitre les pieces de theatre avant les concerts ; cela pourrait se faire ainsi : 

<?xnil version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.0"> 

<xsl:output method='text' encoding='LITF-8'/> 

<xsl itemplate match='/'> 

<xsl :apply-templates/> 
</xsl itempl ate> 



<xsl itemplate match='Saison'> 
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Manifestations au programme 
<xsl :apply-templates sel ect="Theatre"/> 
<xsl rapply-templates sel ect="Concert"/> 
Reservations 10 jours avant la date. 
</xsl :templ ate> 

<xsl itempl ate match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :templ ate> 

<xsl itempl ate match='Theatre'> 

Theatre : <xsl :value-of select="."/> 
</xsl :templ ate> 

</xsl :stylesheet> 

L e resultat obtenu serait alors le suivant : 

Manifestations au programme 



Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 

Reservations 10 jours avant la date. 



Variante syntaxique mode="..." 

On peut si I'on veut ajouter un attri but mode a ('element appiy-tempiates , comme ceci : 

<xsl :apply-templates mode="nom-de-mode" /> 

L'emploi de cet attribut va de pair avec la definition de regies XSLT differentes appli- 
cables au meme element source, ces regies etant etiquetees par un nom de mode pour les 
differencier : 

<xsl :template match=' . . . ' mode="model"> 

i</xsl itempl ate> 
<xsl itempl ate match='... la meme chose mode="mode2"> 
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I 



• </xsl itempl ate> 

Lors de la definition d'un modele de transformation, on peut utiliser instruction 
xsi :appiy-tempiates en precisant le mode choisi, cequi aura poureffetdeselectionner, 
parmi les differentes regies egalement applicables, celle dont le mode est egal au mode 
choisi : 

I <xsl lapply-templates inode="moclel" /> 

L a consequence est qu'un meme element peut etre traite plusieurs fois, par des regies dif- 
ferentes, une par mode. 

C'est cequi distingue la notion de modede celle de priorite : 

• Avec la notion de mode, on introduit volontairement des ambiguites potentielles en 
ecrivant plusieurs regies simultanement eligibles (le plus souvent, el les ont le meme 
motif, mais ce n'est pas obligatoire). Ces regies simultanement eligibles sont asso- 
ciees chacune a des modes differents afin de pouvoir choisir la bonne par I'interme- 
diaire d'une instruction <xsi :appiy-tempiates mode=". . ."/>, qui specifie le mode 
adequat en fonction de I 'instruction en cours. 

• Avec la notion de priorite, on cherche au contraire a eliminer toute ambiguite, en 
affectant une fois pour toutes des priori tes differentes aux regies qui pourraient even- 
tuellement etre simultanement eligibles: a I'execution, si I'ambiguite se presente, 
c'est toujours la meme regie qui est choisie (celle de plus haute priorite), et toujours 
les memes qui sont ecartees. 

En resume, avec la notion de mode, les differents choix possibles restent ouverts 
jusqu'au dernier moment, alors qu'avec celle de priorite, on fermetout des le depart. 



Nous conservons le meme exemple de fichier XM L a traiter ; mais cettefois, imaginons 
que letexte a produiresoit destine a un service municipal qui a notamment en charge de 
prevoir le chauffage des sal les utilisees. On veut un texte qui puisseetre integre dans une 
notede service qui annonce les manifestations a venir, et qui recapitule a la fin les direc- 
tives de chauffage. 

Le probleme ici est qu'un meme element (par exemple <Lieu> ) devra etre traite deux 
fois : une fois en tant que donnee d'une manifestation, et une fois en tant que donnee 
d'une directive de chauffage. 

La solution est de definir deux modes de traitement : un mode « annonce » et un mode 
« logistique ». Le programme XSLT prend la forme suivante : 

<?xml version="1.0" encocling="UTF-8"?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforin" 

version = "1.0"> 



Exemple 



<xsl:output method='text' encoding='LITF-8'/> 
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<xsl itempl ate match='/'> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl itempl ate match='Saison'> 
Manifestations a venir 
<xsl lapply-templates select^ 
<xsl :apply-templates select^ 
Chauffage 

<xsl lapply-templates select^ 
<xsl :apply-templates select^ 
</xsl :templ ate> 



"Theatre" mode="annonce"/> 

"Concert" mode="annonce"/> 

"Theatre" mode="l ogi stique"/> 

"Concert" mode="l ogi stique"/> 



<xsl itempl ate match^'Concert' mode="annDnce"> 

Concert : <xsl :val ue-of select="."/> 
</xsl itempl ate> 

<xsl itempl ate match^'Theatre' mode="annonce"> 

Theatre i <xsl ival ue-of select="."/> 
</xsl itempl ate> 



<xsl itempl ate match^'Concert' mode="log1stique"> 

le <xsl ival ue-of select="Date"/>, <xsl ival ue-of select="Lieu"/> 
</xsl itempl ate> 

<xsl itemplate match^'Theatre' mode="log1stique"> 

le <xsl ival ue-of select="Date"/>, <xsl ival ue-of select="Lieu"/> 
</xsl itemplate> 

<xsl itempl ate match^'Organisation' mode="logistique"> 
</xsl itempl ate> 



</xsl istylesheet> 

Le resultat obtenu est alors le suivant : 

Manifestations a venir 



Theatre i 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre i 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Concert i 
Pygmal ion 
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Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 

Chauff age 

le Mardi 19 novembre 1999 21H , Salle des Cordeliers 

le Mercredi 20 novembre 1999 21H30 , Salle des Cordeliers 

le Samedi 9 octobre 1999 20H30 . Chapelle des Ursules 



Instruction xsl:for-each 

Cette instruction est la cousine de xsi :appiy-tempiates, en ce sens que xsi :appiy- 
tempiates etxsi :for-each sontlesdeux seules instructions du langagequi, lors del'ins- 
tanciation du modele qui les iieberge, provoquent la creation d'une nouvelle liste de 
noeuds, traitee recursivement (voir I nstanciation d 'un module de transformation relative- 
ment a un no-ud courant et une liste courante, page 90). Bien sur, les effets de ces deux 
instructions sont differents, mais neanmoins, elles declenchent des mecanismes assez 
semblables. 



Bande-annonce 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Llrsules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl rstylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transforin" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 
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<xsl itempl ate match='Saison'> 

<xsl :for-each select="Theatre"> 

Date Theatre : <xsl :val ue-of select="Date"/> 
</xsl :for-each> 
</xsl itempl ate> 

</xsl :stylesheet> 

Resultat 

I Date Theatre : Mardi 19 novembre 1999 21H 

Date Theatre : Mercredi 20 novembre 1999 21H30 



Syntaxe 



<xsl :for-each select="... chemin de localisation 



."> 



I </xsl :for-each> 

L'instruction xsi:for-each ne doit pas apparattre en tant qu'instruction de premier 
niveau. 



Regie XSLT typique 

Une regie XSLT utiiisant i'instruction xsi:for-each sera souvent empioyee comme 
ceci : 

<xsl itempl ate match="... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=". . ."> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 



Semantique 



Remarque 

il n'est peut-etre pas inutile de preciser tout d'abord que I'instruction <xsl :for-each> n'est pas une ins- 
truction pour effectuer une boucle, etn'a done rien avoiravec la boucle for( ..;..;..) que I'on trouveen C ou 
en J ava. En particulier, la notion de compteurqui s'incremente est une notion tres etrangere a XSLT : XSLT est 
un langage qui ne permet pas de faire evoluer la valeur d'une variable ; rappelons que XSLT s'apparente aux 
langages fonctionnels (comme ML ou CamI) lorsqu'il s'agitde faire de I'algorithmique. 
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Lors de I'instanciation du modeleenglobant, le motif de la regie est en concordance avec 
le noeud courant (le noeud en cours de traitement) ; instruction <xsi :for-each>, faisant 
partie de ce modele de transformation englobant, est remplacee par le fragment de 
document qui resulte du traitement de la liste des noeuds selectionnes par son attribut 

select=". . .". instruction <xsl :for-each> eSt la Seule, avec <xsl :apply-templates>, 

a induire la construction d'une nouvelle liste de noeuds, eta lancer un traitement sur cette 
liste. Commedans la variantesyntaxique <xsi :appiy-tempiates seiect=" ...">, la liste 
des noeuds a traiter est etablie d'apres la valeur du chemin de localisation fourni dans 
I'attribut seiect=" . . . ". En fait, la seule difference appreciable entre <xsi :for-each 

sel ect=" . . . "> et <xsl : apply-templ ates sel ect=" . . . "> eSt que pOUr xsl : for-each, 

la regie a appliquer a chaque noeud de la liste n'est pas recherchee parmi I'ensemble 
des regies du programme XSLT, comme dans le cas de <xsi :appiy-tempiates seiect= 
"...">, mais au contraire, lememe model ede transformation est applique uniformement 
achacun d'entre eux. 

Le corps de ^instruction <xsi :for-each> (i.e. I'ensemble des elements fils de I'element 
<xsi :for-each>) constituele model e de transformation uniformement applique achacun 
des noeuds Selectionnes. 

L e fragment de document qui resulte du traitement de cette liste est tel que cela ete defini 
dans le modele de traitement : voir M odele de traitement, page 87. 

Exemple 

Saison.xsl 

<?xml version="1.0" encocling="UTF-8"?> 
<xsl :stylesheet 

xnilns:xsl = "http://www.w3.org/1999/XSL/Transforin" 

version = "1.0"> 

<xsl:output method='text' encoding='IS0-8859-l'/> 

<xsl : tempi ate match='Saison'> 

<xsl :for-each sel ect="Thecitre"> 

Date Theatre : <xsl :val ue-of sel ect="Date"/> 

</xsl :for-each> 
</xsl :templ ate> 

</xsl :stylesheet> 

Saison.xml 

<?xml version="1.0" encocling="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 
<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 
<Lieu>Chapelle des Llrsules</Lieu> 
</Concert> 
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<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 



Autre semantique 

L'interpretation naturelle de <xsi :for-each> est celle d'une instruction permettant la 
repetition d'une meme transformation surplusieurs elements. Bien sflr, pour que ceci ait 
un sens, il faut qu'il y ait effectivement une structure reguliere, repetitive d'elements a 
trailer, et que ce fait soitconnu au moment ou I'on ecrit le programme XSLT. 

L'explication de la semantique de cette instruction fait intervenir deux modeles de 
transformation, I'un englobant, I'autre etant le modele de transformation propre au 

<xsl : f or-each> : 

<xsl itempl ate match="... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=". . ."> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 

M ais on peut aussi considerer un seul modele de transformation (ce n'est qu'une ques- 
tion de point devue) : 

<xsl :templ ate match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

... texte ou instructions XSLT ... 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :templ ate> 



</Saison> 



Resultat 



Date Theatre 
Date Theatre 



Mardi 19 novembre 1999 21H 
Mercredi 20 novembre 1999 21H30 
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La seule modification concerne les commentaires : rien n'est done cfiange pour le 
processeur XSLT. Pourtant cette presentation eclaire differemment la semantique du 

<xs1 : f or-each>. 

Le modele de transformation est ici vu comme un modele unique, compose de trois par- 
ties : 

<xsl : tempi ate match^"... motif (pattern) ..."> 
<!-- modele de transformation --> 
<!-- premiere partie --> 
... texte ou instructions XSLT ... 
<!-- fin premiere partie --> 
<xsl :for-each sel ect=" . . . "> 

<!-- deuxieme partie --> 
... texte ou instructions XSLT ... 

<!-- fin deuxieme partie --> 
</xsl :for-each> 
<!-- troisieme partie --> 
... texte ou instructions XSLT ... 
<!-- fin troisieme partie --> 
<!-- fin du modele de transformation --> 
</xsl :template> 

Deslors, le<xsi :for-each> apparait comme une instruction qui cfiange temporal rement 
lenoeud courant pendant I 'instanciati on du modele de transformation, etcepointdevue 
peut etre encore renforce si I 'on imagine que le seiect=" ... " du <xsi :for-each> ne 
selectionnequ'un seul element. 

L'inStruction <xsl :for-each> aurait aUSSi bien pu S'appeler <xsl rchange-current- 
node>. 

En effet, lors de I 'instanciati on des premiere et troisieme parties du modele de transfor- 
mation, le motif de la regie est en concordance avec le noeud courant (le noeud en cours 
de traitement). L' instanciati on de la deuxieme partie sefait avec un autre noeud courant, 
celui selectionne par I'attribut seiect=" . . ." de I 'instruction <xsi :for-each>. 



Exemple 

On met ici en ceuvre un exemple qui reprend I'ideedu modele de transformation en trois 
partie, la deuxieme donnant lieu a une instanciation relativement a un (ou plusieurs) 
noeud(s) courant(s) different(s) du noeud courant en concordance avec le motif ; lefichier 
XML estlememe: Saison.xmi (voir Exemple, page 139) 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xs1 istylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encod1ng='IS0-8859-l'/> 



Les instructions de transformation 

Chapitre 4 



<xsl itempl ate match='Concert'> 
Apres le concert 

<xsl :value-of select="Organisation"/> du <xsl :val ue-of select="Date"/>, 
il y aura encore les spectacles suivants : 
<xsl :for-each select="/Saison/Theatre"> 

Theatre (<xsl :value-of select="Organisation"/>) , 

le <xsl :value-of sel ect="Date"/> 
</xsl :for-each> 
Rappel des sal les : 
<xsl :value-of select="Lieu"/> 
</xsl :templ ate> 

<xsl itemplate match='Organisation'> 
</xsl itempl ate> 

<xsl itempl ate match='Date'> 
</xsl itempl ate> 

<xsl itempl ate match='Heure'> 
</xsl itempl ate> 

<xsl itempl ate match=' Lieu'> 

<xsl ivalue-of select="."/> 
</xsl itempl ate> 

</xsl istylesheet> 

La premiere regie, dont le motif concorde avec lenoeud <concert>, declare un modelede 
transformation en trois parties. 

Premiere parti e 

Apres le concert 

<xsl ival ue-of select="Organisation"/> du <xsl ival ue-of select="Date"/>, 
11 y aura encore les spectacles suivants i 

Deuxieme parti e 

I Theatre (<xsl ivalue-of select="0rgan1sation"/>) , 
le <xsl ival ue-of select="Date"/> 

Troisieme parti e 

j Rappel des sal les i 

<xsl ival ue-of select="Lieu"/> 

La premiere et la troisieme seront instanciees relativement au noeud courant <concert>, 
alors que la deuxieme sera instanciee plusieurs fois, relativement a differents noeuds cou- 
rants (successivementtous les elements <Theatre> enfants de la racine <saison>), 

Le resultat est qu'a chaque fois, les instructions 

<xsl ival ue-of select="Organisation"/> 
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et 

I <xsl :val ue-of sel ect="Date"/> 

de cette deuxieme partie sont instanciees differemment en fonction du noeud courant 
actif. La troisieme partie est instanciee sous la forme : 

IRappel des salles : 
Chapelle des Ursules 

etc'estia regie 

|<xsl :template match='Lieu'> 
<xsl :value-of select="."/> 
</xsl itempl ate> 

qui complete la liste des salles. Appliquee au fichier saison.xmi, cette feuille de style 
produit le resultat suivant: 

Apres le concert Anacreon du Samedi 9 octobre 1999 20H30 

il y aura encore les spectacles suivants : 

Theatre ( Masques et Lyres ), le Mardi 19 novembre 1999 21H 

Theatre ( Masques et Lyres ), le Mercredi 20 novembre 1999 21H30 

Rappel des salles : 
Chapelle des Ursules 



Salle des Cordeliers 



Salle des Cordeliers 

La mise en page, et notamment la repartition des sauts de ligne n'est pas extraordinaire, 
mais nous verrons plus loin comment regler ce genre de probleme. 

Cet exemple met en jeu les regies par defaut, puisque aucune regie n'est fournie pour les 

elements <Saison> et <Theatre>, 

Pour I'element <saison> la regie 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl itempl ate> 

s'applique, et relance le traitement sur les noeuds enfants <concert>, <Theatre>, et 
<Theatre>. Pour I'element <concert> une regie explicite est fournie. Pour les elements 
<Theatre> la regie par defaut 
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<xsl itempl ate match='/|*'> 
<xsl :apply-teniplates/> 
</xsl :tenipl ate> 

s'applique, et relance le traitement sur les noeuds enfants <organisation>, <Date>, et 
<Lieu>, ces elements etant pris en charge par des regies explicites. 
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Bande-annonce 

instruction xsi :sort est une instruction de tri qui ne s'emploie que comme comple- 
ment a xsi :appiy-tempiates ou xsi :for-each : die sert a trier le node-set selectionne 
par I'une de ces deux instructions. L'exemple ci-dessous montre un xsi :sort accompa- 

gnant un xsi :for-each. 
CDtheque.xml 

<?xml version="1.0" encoding="LICS-2" standalone="yes"?> 
<CDtheque> 

<Compositeurs> 

<Compositeur> 

<nom> Couperin </nom> 

<prenom> Louis </prenom> 

<actifVers> 1670 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Thomas </prenom> 

<actifVers> 1610 </act1fVers> 
</Compositeur> 

<Compositeur> 

<nom> Faugues </nom> 

<prenom> Guillaume </prenom> 

<actifVers> 1460 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Aristophane </nom> 

<prenom> flls de Philippos d'Athenes </prenom> 
<actifVers> -410 </act1fVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Christopher </prenom> 
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<actifVers> 1640 </actifVers> 
</Compositeur> 

</Compositeurs> 

</CDtheque> 

CDtheque.xsl 

<?xml version="1.0" encocling="UCS-2"?> 

<xsl rstylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transforiii" version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl :template ntatch="Compositeurs"> 
<xsl :for-each select="Compositeur"> 
<xsl:sort sel ect="nom"/> 
<xsl :value-of sel ect="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat 

I Aristophane Couperin Faugues Simpson Simpson 

Variantedetri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl itemplate match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 

<xsl:sort select="actifVers" data-type="number"/> 
<xsl :val ue-of sel ect="nom"/> 
</xsl :for-each> 
</xsl itempl ate> 
</xsl :stylesheet> 

Resultat 

I Aristophane Faugues Simpson Simpson Couperin 

Syntaxe 

I <xsl :sort/> 

L'instruction xsi :sort nedoit pas apparaitre en tant qu'instruction de premier niveau, et 
doitapparattre dans le model ede transformation d'un xsi :for-each ou d'un xsi :appiy- 

templ ates. 
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Regie XSLT typique 

U ne regie X SLT utilisant ['instruction xsi : sort sera souvent employee comme ceci : 

<xsl itempl ate match="... motif (pattern) ..."> 

<xsl :for-each select=" . . . "> 
<xsl :sort/> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

</xsl itempl ate> 

ou encore comme ceci : 

<xsl itempl ate match="... motif (pattern) ..."> 

<xsl :apply-templates> 

<xsl :sort/> 
</xsl :apply-templates> 

</xsl :templ ate> 

Semantique 

L'instruction <xsi :sort/> ne s'emploie pas seule ; elle est en fait liee aux (jeux instruc- 
tions <xsi :for-each> et <xsi :appiy-tempi ates>, et ne peut s'employer autrement que 
commeassocieea l'une(Jeces(Jeux instructions. 

En I'absence (J'une instruction <xsi:sort/>, les (Jeux instructions <xsi :for-each> et 
<xsi :appiy-tempiates> Constituent une liste des elements a traiter, basee sur l'or(Jre 
naturel 6e lecture 6u (document XML. 

L'instruction <xsi :sort/> intervient (jonc pour motJifier l'or(Jre ties elements tie cette 
liste : par (Jefaut (c'est-a-(jire en I'absence d'attributs propres a <xsi :sort/> permettant 
de specifier les parametres du tri a effectuer), les elements de cette liste sont ordonnes 
suivant I'ordre lexicographique de la valeur textuelle de chaque element. 

L'instruction <xsi :sort/> est touj ours vide; elle peut justeetre completee par differents 
attributs que nous verrons plus loin, 

Utilisee en association avec <xsi :for-each>, elle doit necessairement se trouver placee 
avantle debut du model ede transformation inclusdansce<xsi :for-each>, comme on le 
voit dans I'exemple ci-dessus. 

Note 

Employee dans un xsl : for-each la fonction positionO renvoie le numero d'ordre du nceud courantau sein 
du node-set selecticnne par Tattribut select du xsl :for-each. Si cette instruction xsl :for-each comporte 
une instruction xsl rsort, la numerotation consideree estcelle du node-set reordonne parle tri. 
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Exemple 

Nous reprenons I'exemple relatif a ('instruction <xsi :appiy-tempiates> , tel qu'il est 
traite a la section Instruction xsliapply-templates, page 131. Le fichiers XML est le 
memequecelui deja utilise comme exemple (voir Exemple, page 132) : 

Saison.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Pygmalion </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Aristophane </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Saison> 

Le fichler XSLT est lui aussi le meme, a ceci pres que I'on ajoute une instruction 

<xsl :sort/> a I 'instruction <xsl : apply-templ ates> : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 

<xsl istylesheet xinlns:xsl="http://www. w3.org/1999/XSL/TransfDrm" version="1.0"> 
<xsl:output method='text' encoding='LITF-8'/> 

<xsl itemplate match='/'> 

<xsl :apply-templates/> 
</xsl itempl ate> 

<xsl :template match='Saison'> 
Manifestations au programme 

<xsl :apply-templates> <xsl:sort/> </xsl :apply-templates> 
Reservations 10 jours avant la date. 
</xsl :templ ate> 

<xsl :template match='Concert'> 

Concert : <xsl :value-of select="."/> 
</xsl itempl ate> 

<xsl itemplate match=' Theatre '> 

Theatre : <xsl :value-of select="."/> 
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I</xsl :templ ate> 
</xsl :stylesheet> 
Resultat 



Manifestations au programme 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 

Reservations 10 jours avant la date. 

N ous reprenons le deroulement du processus de traitement sur cet exemple (voir C onsti - 
tution d'une liste ne contenant que la racine, page 108), qui ne cliange en rien, sauf une 
fois arrive a I'etape representee par la figure 3-21, que I'on rappelle ici (voir figure 4-1). 

Sans instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I 'ordre de lecture du document. 

Avec I'instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I 'ordre lexicographique de la valeur textuelle des ele- 
ments (voir figure 4-2). 

La valeur textuelle des trois elements <Theatre/>, <Theatre/>, <concert/> est obtenue 
comme explique a la section No-ud de type element, page 31, et aux figures 3-23, 3-25, 
3-27 de la section Instanciation du module de transformation, page 118. Ici, les mots 
Pygmalion, M asques et Lyres, Aristophane imposent leur ordre lexicographique a leurs 
trois elements respectifs. 
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M odele 



M anifestations au programme 



recopie 



<xsl:apply-templates/> 



remplace par sa valeur 
(l)+(2)+(3)+(4)+(5) 



Fragment de 
document resultat 

M anifestations au programme 



Reservations 10 jours avant la date. 



Traitement 
(2)+(3)+(4)+(5) 



recopie 



Pygmalion 

Samedi9 0ctobrel999 20H30 
Chapellede;Ur5ules 



Ari?toptiane 

M ercredi 20 Novernbre 1999 21H3C 
SalledMCordeliers 



Reservations 10 jours avant la date. 



Generation d'une 
nouvelleliste 
(1) 



L iste a traiter 



Concert 



T heatre 



T heatre 
— •- 



I 
I 

Traitement 
du noeud 
Concert 
(2) 



Concert : 
Pygmalion 

Samedi 9 0ctobrel999 20H30 
ChapelledesUrsules 



I 
I 

Traitement 
du noeud 
Theatre 
(3) 



Theatre : 

M asques et Lyres 

Mardi 19 Novembre 1999 21H 

Salledes Cordeliers 



I 
I 

Traitement 
du nceud 
Theatre 
(4) 



T heatre : 
Aristophane 

Mercredi 20 Novembre 1999 21H30 
Salle desCordeliers 



Concatenation 
(5) 



Figure 4-1 

Instanciation du modele de transformation (sans <xsl:sort/>). 
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M odele 



M anifestations au programme 



recopie 



<xsi:apply-templates> 

<xsl:sort/> 
</xsl:apply-templates> 



remplace par sa valeur 
(l)+(2)+{3)+{4)+{5) 



Reservations 10 jours avant la date. 



Generation d'une 
nouvelleliste 
ordonnee 
lexicographiquement 
(1) 



L iste a trailer 



Theatre 
• — 



Theatre 
— • — 



Traitement 
du noeud 
Theatre 
(2) 



Traitement 
du noeud 
Thratre 
(3) 



Traitement 
{2)+{3)+{4)+{5) 



recopie 



Concert 



Traitement 
du noeud 
Concert 
(4) 



Theatre : 




Theatre : 




Concert : 


Aristophane 




M asques et Lyres 




Pygmalion 


Mercredi 20 Novembre 1999 21H30 




Mardi 19 Novembre 1999 21H 




Samedi9 0ctobrel999 20H30 


Salledes Cordeliers 




Salledes Cordeliers 




Chapelledes Ursulas 



Fragment de 
document resultat 



M anifestations au programme 



An5tophane 
Mercredi 20 N over 
Salledes Cordelier 



Samei)i9 0ctobrel999 20H30 



Reservations 10 jours avant la date. 



Concatenation 
(5) 



Figure 4-2 

Instanciation du module de transformation (avec <xsl:sort/>). 
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Variantes syntaxiques 

On peut, si I'on veut, ajouter a ('instruction <xsi :sort/> les attributs suivants : 

I <xsl:sort select^"..." orders"..." 

' case-order=" . . . " lang="..." data-type=" . . . "/> 

Ces attributs permettent de preciser les differents parametres du tri, que nous allons 
maintenant passer en revue. 

Attribut select 

Signification 

L'attribut select est essentiel, car il definit la cle de tri, c'est-a-dire la chalne de carac- 
teres a extrairede I 'element en cours de placement, sur laquelle portera letri, 

Valeur possible 

On peut fournir une expression XPath quelconque, qui est evaluee, comme il se doit, 
relativement a un noeud contexte et a une liste contexte. 

Le noeud contexte est le noeud en cours de placement, et la liste contexte est la liste de 
noeuds (conservee dans son etat originel), produite par I'instruction directement englo- 
bante, c'est-a-dire, suivant les cas, soit par I'instruction <xsi :appiy-tempiates/>, soit 

par I'instruction <xsl :for-each/>. 

Cette expression ne donne pas forcement une chalne de caracteres comme resultat (on 
obtient meme un node-set dans le cas le plus general), mais s'il le faut, la fonction 
stringo lui est appliquee, et la chaine de caracteres qui en resulte constitue alors la cle 
detri. 



Note 

II y a en fait deux listes en jeu : celle avantetcelle apres le tri. Le fait que la liste contexte soitcelle conservee 
dans son etat originel, done avantle tri, rend possible I'utilisation de la fonction positionQau sein de I'expression 
XPath. 

Valeur par defaut 

La valeur par defaut est egale a stringc.), qui n'estrien d'autre que la valeur textuelle 
du noeud courant, 

Autres attributs 

Les autres attributs sont des parametres qui permettent de regler la fagon dont le tri est 
effectue. 

• order 

L'attribut order definit I'ordre du tri (ascendant ou descendant) ; il peut prendre I'une 

des deux valeurs ascendl ng ou descend! ng, et Sa valeur par defaut est ascendl ng. 
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Note 

Techniquement, sontacceptees ici des valeurs d'attributordinaires (des chaines de caracteres, comme on en a 
I'habitude), mais aussi, etde fagon assez exceptionnelle en XSLT, des Attribute Value Template, notion qui sera 
introduite beaucoup plus loin (voir Descripteur de valeur differee d'attribut (Attribute Value Template), page 269). 
Mais on pourra ignorercett:e remarque en premiere lecture, puisque les valeurs d'attributs ordinaires sontaccep- 
tees. 



• Cise-order 

L'attribut case-order definit la relation d'ordre entre les lettres minuscules et majus- 
cules ; 11 peut prendre I'une des deux valeurs upper-first ou lower-first, etsa valeur 
par defaut depend de la langue utilisee. 

• 1 ang 

L'attribut lang definit la langue utilisee, et par la meme, les conventions detri propres 
a cette langue ; sa valeur est un des codes de langue definit par X M L , et sa valeur par 
defaut depend de I'environnementdetraitement. 

• data-type 

L'attribut data-type definit la nature de la cle, afin de savoir comment comparer deux 
cles, Essentiellement, cette nature peut etre de type texte (comparaison de chaines de 
caracteres) ou numerique (comparaison denombres) ; sa valeur est done soittext, soit 
number. Une autre valeur possible est un code special propre a une implementation 
particuliere de XSLT, qui offre cette valeur en extension, et indique naturellement ce 
qu'ellesignifie. On peut penser qu'un code date seraittres utile, car hen n'a ete prevu 
en standard pour comparer des dates lors d'un tri, alors que ni text ni number ne 
conviennent. 

La valeur par defaut est "text". 
Exemple 

On dispose d'une base de donnees de CDtheque, constitute d'informations sur les com- 
positeurs, lesoeuvres, les enregistrements, etc. 

U n extrait de cette base pourrait ressembler a ceci : 
CDtheque .xml 

<?xml version="1.0" encoding="UCS-2" standalone="yes"?> 

<CDtheque> 

<Compositeurs> 

<Coiiipositeur> 

<noni> Couperin </nom> 
<prenom> Louis </prenom> 
<actifVers> 1670 </act1fVers> 
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</Compositeur> 



<Compositeur> 

<nom> Simpson </noni> 
<prenom> Thomas </prenom> 
<actifVers> 1610 </actifVers> 

</Compositeur> 



<Compositeur> 

<nom> Faugues </nom> 
<prenoni> Guillaume </prenoni> 
<actifVers> 1460 </actifVers> 

</Compositeur> 



<Conipositeur> 

<nom> Aristophane </nom> 

<prenom> fils de Philippos d'Athenes </prenom> 
<actifVers> -410 </actifVers> 
</Compositeur> 



<Compositeur> 

<nom> Simpson </noni> 

<prenom> Christopher </prenom> 

<actifVers> 1640 </actifVers> 

</Compositeur> 



</Compositeurs> 



</CDtheque> 

Pour editer les compositeurs par ordre alphabetique de leur nom, on peut ecrire la feuille 
destylesuivante : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itemplate match="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl :value-of sel ect="nom"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

L e resultat obtenu est le suivant : 

I Aristophane Couperin Faugues Simpson Simpson 
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Letri sefaitici avec toutes les valeurs par defautdes attributs order, case-order, lang, 

et data-type, 

Supposons maintenant que nous voulions faire un tri par les dates, nous pouvons alors 
extraire lecontenu de I 'element <actifvers> pour en faire unecle de tri. A fin de mon- 
trer la difference entre tri numeriqueettri alphanumerique, nous avons ajoute une entree 
« A ristophane » dans le fichier XML donne, 

Note 

Aristophane etaitun Grec, actif vers le iv^ siecle avantj C, qui nous a laisse un peu de musique, gravee surdes 
dalles de marbre conservees a Delphes. Cette musique a reellementete enregistree surCD (plus recemment). 

CDtheque.xsl 

<?xml version="1.0" encoding="LICS-2"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itemplate match="Compositeurs"> 
<xsl :for-each select="Coinpositeur"> 

<xsl:sort select="actifVers" data-type="number"/> 
<xsl : val ue-of select="noin"/> 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

Le resultat obtenu est le suivant : 

I Aristophane Faugues Simpson Simpson Couperin 

On remarquera que ce qui est appele ici tri sur les dates est en fait un tri sur des entiers, 
car il n'y a pas encore, en XSLT, de typededonnee normalise correspondant a une date. 

Si on avait omis de preciser I'attribut data-type, sa valeur par defaut (text) aurait ete uti- 
lisee, ce qui aurait donne le resultat suivant : 

I Faugues Simpson Simpson Couperin Aristophane 

Tri a cles multiples 

I I est possi bl e de preciser plusieurs cles de tri : quand deux elements ont meme valeur par 
la premiere cle de tri, on les departage avec la deuxiemecle, et ainsi de suite. Dans notre 
exemple, on peut utiliser une deuxieme cle de tri sur le prenom, pour affiner le tri sur le 
nom qui donne un doublon (Simpson). 

Voyons ce que donne I 'edition du nom + prenom sans cle de tri secondaire (remarquer la 
presence d'un « » ; « » xsl:value-of ) : 
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CDtheque.xsl 

<?xnil version="1.0" encoding="UCS-2"?> 

<xsl rstylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output inethod='text' encoding=' ISO-8859-r /> 

<xsl itemplate niatch="Compositeurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl :val ue-of sel ect="nom"/> 
<xsl :value-of select="prenom"/>; 
</xsl :for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

L e resultat obtenu est le suivant : 

Aristophane fils de Philippos d'Athenes ; 
Couperin Louis ; 
Faugues Guillaume ; 
Simpson Thomas ; 
Simpson Christopher ; 

Nous necherchons pas pour I'instant a expliquer la presentation obtenue, notamment la 
presence des sauts de ligne, qui ne se manifestaient pas dans les exemples precedents, 

On observe que les deux Simpson ne sont pas classes dans I'ordre de leur prenom. On 
ajoute alors une deuxieme cle de tri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers1on="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl :template match="Compos1teurs"> 
<xsl :for-each sel ect="Compositeur"> 
<xsl:sort sel ect="nom"/> 
<xsl:sort select="prenom"/> 
<xsl :value-of sel ect="nom"/> 
<xsl :value-of select="prenom"/>; 
</xsl : for-each> 
</xsl :templ ate> 
</xsl :stylesheet> 

L e resultat obtenu est le suivant : 

Aristophane fils de Philippos d'Athenes ; 
Couperin Louis ; 
Faugues Guillaume ; 
Simpson Christopher ; 
Simpson Thomas ; 
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Instruction xsl:copy-of 

Cette instruction est la cousine de <xsi :vaiue-of/> ; mieux : partout oil <xsi :vaiue- 
of/> est utilisee, on pourrait la remplacer par <xsi :copy-of/> sans que cela change le 
resultat obtenu. Bien sur, la reciproque est fausse, et remplacer une occurrence quel- 
conquede <xsi :copy-of/> par <xsi :vaiue-of/> peut changer I e resultat, 



Bande-annonce 

L'instruction <xsi:copy-of seiect=". . ."/> est Instanciee sous la forme d'une copie 
conforme des elements selectionnes. 



Concert.xtnl 

I <?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 



<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Llrsules</Lieu> 

<Interpretes> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Noin> Silvia Abramowicz </Noin> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Interpretes> 



</Concert> 
Concert.xsl 

^ <?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xmr encodings' ISO-8859-r indent^'yes' /> 



<xsl itemplate match=" Interpretes"> 
<Musiciens> 

<xsl :copy-of sel ect=" Interprete"/> 
</Musiciens> 
</xsl itempl ate> 

<xsl itemplate match="text( ) "X/xsl :template> 



</xsl :stylesheet> 
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Resultat 

<?xnil version="1.0" encoding="IS0-8859-l"?> 
<Musiciens> 
<Interprete> 

<Nom> Jonathan Dunford </Noin> 

<Instruinent>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instruinent>Basse de viole</Instrument> 

</Interprete> 
</Musiciens> 

Syntaxe 

I <xsl:copy-of select^"... chemin de localisation ..."/> 

L'instruction xsi:copy-of ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Regie XSLT typique 

Une regie XSLT utilisant l'instruction xsi :copy-of sera souvent employee commececi : 

<xsl :templ ate match="... motif (pattern) ..."> 

<xsl:copy-of sel ect=" . . . "/> 
</xsl itempl ate> 

Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le noeud 
courant (le noeud en cours detraitement). C'estce noeud qui fait office de noeud contexte 
dans devaluation du cliemin de localisation fourni comme valeur de I'attribut select, 

L'instruction <xsi :copy-of>, comme son nom I'indique, effectue une copie du resultat 
de I 'evaluation du chemin de localisation. 

Si ce resultat est une chaine de caracteres, un booleen, ou un nombre, xsi :copy-of et 
xsi : vai ue-of ont exactement le meme effet (voir S<?mantique, page 129). 



Si le resultat est un node-set, I ' effet est tres different: le node-set est serialise. 
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La Serialisation d'un node-set est une operation tres simple (malgre son nom un peu 
impressionnant), qui a pour resultat un fragment de document constitue de la juxtaposi- 
tion (ou concatenation) des fragments de documents obtenus en serial isant successive- 
ment chacun des noeuds du node-set, pris dans I'ordre de lecture du document source 
(voir figure 4-3). 



root # 



Interpretes 



node-set 




ordre de 
lecture du 
document 



Serialisation 



Interprete 



Nom Instrument 



Jonathan Basse Silvia Basse 

Dunford de viole Abramowicz de viole 



<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstrument> 

<lnterprete> 

<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 

<lnterprete> 



Serialisation 



<lnterprete> 
<Nom>J onathan Dunford </Nonn> 
<lnstrunnent> Basse de viole </lnstrunnent> 

</lnterprete> 



Serialisation 



<lnterprete> 
<Nom>Silvia Abrannowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 

</lnterprete> 



Figure 4-3 

Serialisation d'un node-set. 



Concatenation 



La Serialisation d'un noeud, quant a elle, est une operation encore plus simple qui 
consiste a voir ce noeud en tant que racine d'un sous arbre, et a serialiser cesous-arbre. 

Nousavonsdejavu cela, (voir Construction - serialisation, page 84) mais rappelons que 
la Serialisation d'un arbre (ou d'un sous-arbre), est I 'operation inverse de sa construction 
a partir d'un document (ou d'un fragment de document) : la construction prend un (frag- 
ment de) document etcree I e (sous) arbre equivalent; la serialisation redonnele (fragment 
de) document d'origine (voir figure 4-4), 
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Figure 4-4 

Serialisation 
d'un arbre. 



Document XML 

<Concert> 

<Date>J eudi 17 J anvier 2002, 20H30<yDate> 
<Lieu>Chapelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstrument> 
<yinterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de vioie </lnstrument> 
<yinterprete> 
</lnterpretes> 
<:/Concert> 

Construction 



Serialisation 





^root 




^Concert 


Date 
• 


Lieu Interpretes 
• • 


)eudi 17|aiiuier2002, 20H30 


Interprete Interprete 

Nom Instrument Nom Instrument 
• • • • 

J onathan DunFord Ba;5e de uiole Silvia Abramowici Bas^e de viole 



Arbre XML du document 



Remarque 

Si Ton raisonne en terme d'arbre XML etnon pas en terme de document, il est equiva lent de dire que I'instruction 
<xsl :copy-of> provoque un duplicata recursif d'un ensemble de sous-arbres : chaque nceud du node-set est 
duplique de telle sorte qu'il soit recursivement identique au nceud original ; on obtient alors un duplicata certifie 
conforme de chacun des sous arbres ayantpourracines les noeuds originauxdu node-set de depart 
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Note 

Deux noeuds recursivementidentiques sontdeux noeuds que rien ne permetde distinguer :ils ontles meme attri- 
but3, les memes namespaces, et les memes noeuds enfants, qui sont eux-memes recursivement identiques 
deux a deux. 

Exemple trivial 

Cet example expli cite la programmation dela serialisation (montreea lafigure4-3). II est 
trivial en ce sens qu'il ne fait rien de tres interessant. 

Concert.xtnl 

i <?xml version="1.0" encoding="LITF-16" standal one="yes"?> 
<Concert> 

<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Noin> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
</Interpretes> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl istylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xml ' encodings' ISO-8859-r indent^'yes' /> 

<xsl : tempi ate match=" Interpretes"> 
<Musiciens> 

<xsl :copy-of select="Interprete"/> 
</Musiciens> 
</xsl :templ ate> 

<xsl itemplate match="text( ) "X/xsl :template> 



</xsl :stylesheet> 



Instruction xsl:copy-of 

Chapitre 4 



Resultat 

<?xnil version="1.0" encoding="IS0-8859-l"?> 
<Musiciens> 
<Interprete> 

<Nom> Jonathan Dunford </Noin> 

<Instruinent>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instruinent>Basse de viol e</Instrument> 

</Interprete> 
</Musiciens> 



Autre exemple 

Etant donne que ('instruction <xsi :copy-of> sert a dupliquer un (ou des) sous arbre(s) 
XML, il semble assez evident qu'elle sera surtout utile lors de transformations XML 
versXM L, II y a neanmoins un autre cas d'utilisation assez frequent, des lors que I'on 
manipule des variables. On en verra des exemples a la section Pattern n°2 - Fonction, 
page 396, 

Dans I'exemple qui suit, il s'agit d'expurger un document XML, pour en retirer de 
I'information : 

BaseProduits .xml 

<?xml version="1.0" encoding="UCS-2" standal one="yes"?> 
<BaseProduits> 

<LesProduits> 

<L1vre ref="vernesl" NoISBN="193335" gamme="roinan" media="papier"> 
<refOeuvres> 

<Ref valeur="200001 slni"/> 
</refOeuvres> 

<Prix valeur="40.5" inonnaie="FF"></Pr1x> 
<Prix valeur="5" nionna1e="£"/> 
</Livre> 

<L1vre 

ref="boileaunarcejacl" NoISBN="533791" gaiiime="roman" iiiedia="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeLivres> 
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<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Li vre> 

<Enregistrement 

ref="maraisl" Ref Ecliteur="LC000280" gamme^'violedegambe" media="CD"> 
<refOeuvres> 

<Ref valeur="niarais.folies"/> 

<Ref val eur= "ma rais .pieces 1685" /> 
</refOeuvres> 
<Interpretes> 

<Interprete noiii="Jonathan Dunford"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :1 ang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete nom="Sylvia Abramowi cz"> 

<Role xml : 1 ang="f r"> Basse de viole </Role> 

<Role xml : 1 ang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Benjamin Perrot"> 

<Role xml :1 ang="fr"> Theorbe et guitare baroque </Role> 
<Role xml : 1 ang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Freddy Eichelberger"> 

<Role xml :1 ang="fr"> Clavecin </Role> 

<Role xml :1 ang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 

<Titre xml :lang="fr"> Les Folies d'Espagne et pieces inedites </Titre> 
<Titre xml :lang="en"> Spanish Folias and unedited music </Titre> 
<Prix valeur="140" monnaie="FF"/> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 

<Materiel 

ref="HarKarl" refConstructeur="XL-FZ158BK" 
gamme="lecteurCD" marque="HarKar"> 
<refCaracteristiques> 

<Ref val eur="caracHarKarr7> 
</refCaracteristiques> 
<Prix val eur="4500" monnaie="FF"/> 
<Prix valeur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<!-- ... etc : le fichier continue avec d'autres elements --> 
</BaseProduits> 
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Ce fichier XML rassemble des elements d'une base de donnees de produits, et Ton veut 
ecrire un programme XSLT permettant de creer un fichier des livres uniquement. 

Rien de plus simple : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xinl ' encoding='IS0-8859-l' indent='yes' /> 

<xsl : tempi ate inatch="/"> 
<Livres> 

<xsl :apply-templates/> 
</Livres> 
</xsl :teniplate> 

<xsl : tempi ate match="Livre"> 
<xsl:copy-of select="."/> 
</xsl :template> 

<xsl :template match="textC )"></xsl :template> 
</xsl :stylesheet> 

Etvolcl cequ'on obtient : 
livres.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Li vres> 

<Livre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 
</Livres> 

Dans I' instruction : 

I <xsl:output method^'xml' encoding=' ISO-8859-1 ' indent='yes' /> 
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I'attribut indent permet d'obtenir une indentation (pas tres convaincante, il est vrai) ; si 
on I'avaitomis, voici cequ'on auraitobtenu : 

1 i vres .xml 

<?xml version="1.0" encoding="IS0-8859-r?> 

<Livres><Livre ref="vernesl" NoISBN="193335" gainme="roman" inedia="papier"> 
<refOeuvres> 

<Ref valeur="200001slni"/> 
</refOeuvres> 

<Prix val eur="40. 5" nionnaie="FF"/> 
<Prix valeLir="5" monnaie="£"/> 
</Li vreXLi vre ref="boi 1 eaunarcejacl" NoISBN="533791" ganime="roman" 
niedia="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" iiionnaie="£"/> 
</Livre></Livres> 

A u fait, pourquoi avoir integre a ce programme XSLT la regie montreeci-dessous ? 

I <xsl itempl ate match="text()"></xsl :template> 

Pour voir son utilite, commengons par voir ceque I'on obtiendrait si on la supprimait : 

BaseProduits.xsl 

<?xirl version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transforin" version="1.0"> 

<xsl:output inethDd='xmr encoding=' ISO-8859-1 ' indent^'yes' /> 

<xsl : tempi ate match="/"> 
<Livres> 

<xsl :apply-templates/> 
</Livres> 
</xsl :templ ate> 

<xsl itempl ate match="Livre"> 
<xsl:copy-of select="."/> 
</xsl itempl ate> 

</xsl istylesheet> 

1 i vres .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
k <Livres> 
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<Livre ref="vernesl" NoISBN="193335" gamine="roman" media="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" inonnaie="£"/> 



<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamme="roman" ineclia="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" nionnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 



Basse de viole 
Bass Viol 



Basse de viole 
Bass Viol 



Theorbe et guitare baroque 
Theorbo and baroque guitar 



CI avecin 
Harpsichord 



</Livre> 



</Livre> 



Les Folies d'Espagne et pieces inedites 
Spanish Folias and unedited music 
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</Livres> 

Ce fatras de textes (apres la derniere balise fermante </iivre>) et de lignes blanches 
intempestives fait reellement partiedu resultatobtenu ; c'estia regie par defaut 

I <xsl itempl ate match="text()"><xsl :value-of sel ect=" . "/X/xsl : tempi ate> 

qui en est responsable. 



5 



Les instructions 
de programmation 



Les instructions de programmation sont des instructions qui permettent, soit de condi- 
tionner I'instanciation d'un modele de transformation a la valeur d'une expression boo- 
leenne, soit de manipuler des variables, des parametres, et des model es nommes (named 
templates) qui font office decequ'on appelleraitfonction dans des langagescommeC ou 
Java. C'estmaigre, a premiere vue. Pas de boucles de repetition d'aucune sorte (on rap- 
pel I e que I 'instruction xsl:for-each n'est pas une boucle au sens algorithmique du terme, 
voir Instruction xsl:for-each, page 137), aucune possibilite de faire evoluer la valeur 
d'une variable (adieu compteurs, incrementations, effets de bord, et toutes ces sortes de 
chosesqui font partie des canons de la programmation en C) ; pas de boucle, done encore 
moinsde break, et pas plus de return pour sortir prematurement d'une fonction, pardon, 
d'un modele nomme. Cote structures dedonnees, c'est encore pi re: pas de tableaux, pas 
de struct comme en C ou de ci ass comme en J ava, pas de listes, pas de hash-tables, ni 
quoi que ce soit d'autre. Ah, si ! II y en a une : la structure d'arbre de type RTF (Result 
Tree Fragment) ; mais pas de chance, c'est une WOM (Write Only M emory) : on peuty 
ranger des elements, mais on ne peut les y retrouver Individuellement... 

Dans ces conditions, comment peut-on encore vouloir programmer quoi que ce soit avec 
un tel langage ? A utant vouloir percer un mur avec un tire-bouchon. 

Et pourtant ,,, Lecroirez-vous? XSLT estun langage Turing-complet , comme disent les 
savants. 

Alan Turing etait un mathematicien anglais, qui dans les annees 1936-1937, a fonde la 
theorie de la calculabilite (qui a pour objet de savoir si toute fonction est calculable, ce 
qu'est une fonction calculable, etc.). II adefini cequ'on appelleaujourd'hui une machine 
deTuring, qui, par definition de la calculabilite, peut calculer tout ce qui est calculable en 
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un nombrefini d'operations. Un langageTuring-complet est un langageavec lequel on 
peut programmer tout ce qu'une machine de Turing peut calculer, c'est-a-dire tout... ce 
qui est calculable. 

On a du mal a lecroire, apres le resume des prouesses deXSLT en la matiere. M ais c'est 
pourtant vrai. 

En effet, les model es nommes (ou fonctions) peuvent etre appeles recursivement ; il y a 
la possibilite de tester une condition avec instruction xsi:if ; enfin on peut se 
debrouiller pour bricoler une structure de tableau, en la construisantcommeun arbre, que 
I'on convertitensuiteen chaine de caracteres, I'acces aux elements sefaisant en I'explo- 
rant grace aux fonctions XPath predefinies (notamment substring, substring-after, 
substring-before). Or, il estconnu qu'on peut tout programmer en disposantseulement 
de tableaux, de la recursion, et de tests. C'est done vrai qu'on peut tout programmer en 
XSLT. M ais il est evidemment hors de question de programmer quoi que soit dans ces 
conditions : c'esttotalement inutilisableen pratique, sauf eventuellement pour des traite- 
ments extremement simples. 

Heureusement, dans la realite, la situation est un peu meilleure : en effet, la plupart des 
processeurs XSLT disponibles offrent une extension sous forme d'une fonction de 
conversion, qui permet de convertir le type RTF en vrai node-set ; du coup, on peut lui 
appliquer n'importe quelle expression XPath, et done extraire nominativement et com- 
modementtoute information individuelle qui s'y trouve. 

Cela change enormement la puissance du langage en terme de programmation, car on 
peut des lors construire des structures de donnees aussi complexes que Ton veut (et pour 
cela, un arbre n'est pas un mauvais choix), et recuperer les informations stockees sans 
difficulte particuliere. 

De plus, ce qui pour I'instant (par rapport a XSLT 1.0) est une extension indispensable, 
devrait bientot devenir une extension inutile : en effet, la prochaine version de XSLT 
(XSLT 2.0) prevoit d'unifier les notions de RTF et de node-set, rendantainsi caduquela 
fonction deconversion RTF vers node-set. 



Note 

II existe une version intermediaire, XSLT 1.1, mais qui est et restera sous forme de Working Draft : il n'y aura 
jamais de Recommendation XSLT 1.1, parce les evolutions prevues parle Worthing Draft 1.1 ne sontpas mi- 
neures, etrisquentde restreindre le champ d'investigation des travauxsuria 2.0, tantqueces derniers neseront 
pas suffisammentavances pourqu'il soit possible de comprendre finementles implications de I'heritage impose 
par un Worthing Draft 1. 1 promu au rang de Recommendation. Les travaux sur le Worliing Draft 1. 1 ont done ete 
interrompus, eties propositions d'evolution qu'il prevoyaitontete incorporees aux propositions d'evolution pour 
la 2.0. 

Ceci dit, il reste vrai que la programmation en XSLT n'est pas une chose tres aisee, 
d'abord parce que c'est une programmation fonctionnelle pure, done assez etrangere, en 
general, a ce qui nous est familier ; ensuite parce que le langage est extremement spar- 
tiate (on peut difficilement imaginer un langage plus minimaliste) ; enfin parce que la 
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bibliotheque de fonctions predefinies n'est pas tres developpee (encore que cela puisse 
evoluer dans les prochaines versions). 

Audemeurant, il fautresterconscientqueXSLT n'est pas un langagecongu pourfairede 
I'algorithmique, mais pour faire des transformations d'arbres XML, cliose qu'il fait 
extremement bien, reconnaissons-le (a tel point que lorsqu'on a un stocl< de donnees 
informelles a traiter, quelles qu'elles soient, se pose desormais la question de savoir s'il 
ne vaudrait pas mieux commencer par structurer ses donnees en XM L, puis de les sou- 
mettre a une transformation XSLT, plutot que d'ecrire un programme ad-hoc en C ou 
Java). II fautdonc plutot voir les possibilitesde programmation comme des complements 
a la manipulation et la transformation d'arbres XM L, et sous cet angle, il est incontes- 
table que ces complements decuplent la puissance du langage de transformation, 

Instruction xshif 

Bande-annonce 

<xsl itemplate niatch="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :apply-templates/> </H3> 
</xsl itempl ate> 

<xsl :template match="Compositeur"> 
<xsl :val ue-of select="."/> 

<xsl:if test="not(position( ) = last())">, </xsl:if> 
</xsl itempl ate> 

Cet exemple montre une instanciation conditionnelle d'une partie d'un modele de trans- 
formation : une virgule est ajoutee a la valeur textuelle du noeud courant, sauf si c'est le 
dernier de la liste constituee par <xsi :appiy-tempiates/>, On obtient ainsi une liste 
d' items separes par des virgules. 

Syntaxe 

xsl :if 

<xsl:if test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :if> 

L'instruction xsi :if nedoit pas apparattre en tant qu'instruction de premier niveau. 

Regie XSLT typique 

Une regie XSLT utilisant l'instruction xsi :if sera souvent employee comme ceci : 

<xsl itempl ate match="... motif (pattern) ..."> 
I <xsl:if test=" ... expression XPath ... "> 
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<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 



</xsl :if> 



</xsl :templ ate> 



Semantique 

L'expression X Path fournie en tant que valeur de I'attribut test est evaluee, et sa valeur 
est eventuellement convertie en booleen s'il le faut, en lui appliquant la fonction 
booieano. Rappelons (voir sectionboolean trueO, page 636) que cette fonction renvoie 
true si et seulement si son argument est un nombre non nul, ou une String de longueur 
non nulle, ou un node-set non vide. 

Si la valeur de I'attribut test est egale a true, le modele de transformation associe est 
instancie ; sinon, 11 nel'estpas. 

II n'y a pas de else possible, allant de pair avec le xsi :if ; si I'on veut une alternative a 
deux branches, 11 faut utiliser instruction xsi :choose. 

Example 

N ous reprenons notre fichier XML d'annonce de concert : 
Concert.xtnl 

<?xml version="1.0" encoding="LITF-16" standal one="yes"?> 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>JeLidi 17 janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 



<Concert> 
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<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Coniposi teur>M. Marais</Composi teur> 

<Coniposi teur>D. Castel 1 o</Compositeur> 

<Composi teur>F. Rognoni</Composi teur> 
</Compositeurs> 

</Concert> 

Comme dans le tout premier exemple vu, (voir figure 3-1), nous cfierchons a en faire une 
page HTM L, avec les compositeurs presentes sous la forme d'une liste de noms separes 
par une virgule. 

M ais la difficulte est ici que les virgules ne sont pas fournies dans le texte du fichier 
XML. C'estdonc la feuillede style XSL qui va devoiren inserer uneapres chaque nom, 
sauf apres le dernier (d'ou intervention d'une instruction xsi : if pour tester cette condi- 
tion), 

Comment exprimer la condition ? II faut constituer un node-set contenant les <composi - 
teur>, sachant que le dernier repondra au test positionc ) = lasto. 

Voyons ce que cela donne si nous ecrivons une regie dont le motif concorde avec 

<Compositeur> : 

<xsl :template match="Compositeur"> 

</xsl itempl ate> 

Supposons que le noeud courant soit par exemple le <compositeur> D. Castello, et que 

I 'algorithme de recherche de concordance se lance ; il va determiner que le motif de cette 
regie concorde avec le noeud courant, parce qu'en prenant le noeud parent <composi- 
teurs> comme noeud contexte, et en evaluant I'expression XPath "child: : compo- 
siteur", on obtient un node-set detrois elements <compositeur>, qui contient le noeud 
courant, Dans ce node-set, le noeud courant a la position 2, letestpositiono = lasto 
devrait done repondre f ai se. 

II semble done que cela devrait pouvoir marcher ; neanmoins si on essaye, on constate 
quecen'est pas lecas. En cherchant un peu, on finit par determiner que les trois elements 
<Compositeur> n'ont pas comme position (dans le node-set dont i I estquestion ci-dessus) 
1, 2, et 3, mais 2, 4, 6. C'est du a ce que I 'element <compositeurs> n'a pas trois enfants 
directs, mais sept : 

• un premier enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne ; 

• un deuxieme enfant de type element, <Compositeur>M. Marais</Compositeur> ; 
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• un troisieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne ; 

• un quatriemeenfantdetypeelement, <Compositeur>D. Castello</Compositeur> ; 

• un cinquieme enfant de type text ne contenant que des espaces, tabulations ou finsde 
ligne ; 

• un Sixiemeenfantdetypeelement, <Compositeur>F. Rognoni</Compositeur> ; 

• un septieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne. 

Note 

Revoir a ce sujet la section Example d'arbre XML d'un document, page 38. 

La solution, pour retablir unenumerotation plus conformea I'intuition, est bien sur d'eli- 
miner ces noeuds «parasites» de type texto, ce que I'on fait grace a instruction 

<xsl :strip-space element="CompositeLirs"> . 

On aboutlt alors a la feuille de style suivante : 
Concert.xsl 

I <?xml version="1.0" encoding="UTF-16"?> 

' <xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='htinl ' encoding='IS0-8859-r /> 

<xsl istrip-space eleinents='Compositeurs'/> 

<xsl :templ ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /Entete'VX/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl itempl ate> 

<xsl itemplate match="Entete"> 

<p> <xsl :val ue-of select="."/> presentent </p> 
</xsl :templ ate> 

<xsl :templ ate match="Date"> 

<H1 al ign="center"> Concert du <xsl :value-of select="."/> </Hl> 
</xsl :templ ate> 



<xsl itemplate match="Lieu"> 
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<H4 align="center"> <xsl :val ue-of select="."/> </H4> 
</xsl itempl ate> 

<xsl itemplate niatch="Enseinbl e"> 

<H2 align="center"> Ensemble <xsl :value-of sel ect=" . "/></H2> 
</xsl itempl ate> 

<xsl itemplate match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl : apply-templ ates/> </H3> 
</xsl :templ ate> 

<xsl itemplate match="Compositeur"> 
<xsl :value-of select="."/> 

<xsl:if test="not(position( ) = last())">, </xsl:if> 
</xsl itempl ate> 



<xsl itempl ate match="text( )"/> 



</xsl :stylesheet> 

Le modele de transformation associe a ^instruction xsi :if n'est instancie que pour les 
elements dont la position (dans le node-set calcule lors de la recherche de concordance) 
n'est pas la derniere. 

Remarquons aussi la derniere regie, vide, qui remplace la regie par defaut s'appliquant 
aux textes, ceci afin d'eviter la presence dans le resultat des noeuds ignores par cette 
feuillede style, notamment <Nom> et <instrument>. 

Le resultat obtenu est lesuivant (voir aussi la figure 5-1) : 

Concert .html 

<html> 
<head> 

<nieta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d&#8217:Anacr&eacute:on </title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<p> Les Concerts d’Anacréon pr&eacute:sentent </p> 
<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 
<H4 align="center">Chapelle des Ursules</H4> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
<H3 al ign="center"> Oeuvres de <br>M. Marais, D. Castello, F. Rognoni 
</H3> 
</body> 
</html> 

Terminons en indiquant qu'il n'etait peut-etre pas necessaire de trier les elements pour 
lesquels on elimine les enfants detype texto ne contenant que des espaces blancs (i.e. 
un espace, une tabulation, un retour ligne ou un saut de ligne). Si I'on veut elaguer par- 
tout, on eCrira plutot : <xsl :strip-space element="*">. 



Les instructions de programmation 

Chapitre 5 



Figure 5-1 

Listedenoms se'pares 
par des virgules. 



i Netscape: Les Concerts d'Anacreon [ 



■4 ^' ^ ^ si ^ 

Back Forward Reload Home Search Netscape Irri^ges Print 



Les Concerts d'Anacreon presentent 

Concert du Jeudi 17 Janvier 
2002, 20H30 

Chapelledes Ursules 

Ensemble «A deux violes esgales» 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 
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<xsl :choose> 



<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
select= "Interprete [2] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/><xsl :if test="not(position( ) 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwi se> 



</xsl :choose> 
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Cet exemple montre une instanciation conditionnelle de plusieurs fragments de modeles 
de transformation. Le but est d'obtenir trois formes possibles d'enumeration, suivant le 
nombre d'elements a enumerer : 

• XXX : dans le cas oil 11 n'y a qu'un seul element ; 

• XXX et XXX : dans I e cas oil i I y a deux el ements ; 

• XXX, XXX, XXX : dans le cas oil 11 n'y a plus de deux elements. 

Syntaxe 

xsl tchoose 

<xsl :choose> 

<!-- autant de xsliwhen que I'on veut, mais au moins 1 en tout --> 

<xsl:when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 

<xsl :when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 



<!-- 1 'element xsl lotherwise est facultatif --> 
<xsl :otherw1se> 

<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :otherwise> 

</xsl :choose> 

instruction xsi :choose nedoit pas apparaitre en tant qu'instruction de premier niveau. 

Regie XSLT typique 

Une regie XSLT utilisant I'instruction xsi : choose sera souvent employee commececi : 

|<xsl :templ ate match="... motif (pattern) ..."> 
<xsl :choose> 
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<xsl iwhen test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte on instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl :when> 

<xsl :otherwise> 

<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :otherwise> 

</xsl :choose> 
</xsl :templ ate> 

C 'est ('equivalent du if avec sesdeux brandies tlien etelse. 
Semantique 

C'est une instruction qui instancieau plusun modele de transformation. Les expressions 
XPath des differents elements xsi :when sont evaluees en sequence; des que I'une est 
vraie, le modele de transformation associe est instancie ; si aucune n'est vraie, et si un 
element xsi : otherwise est present, son modele de transformation associe est instancie. 
Si aucune n'est vraie, ets'il n'y a pasd'elementxsi :otherwise, aucun modele de trans- 
formation n'est instancie. 

II n'est done pas necessaire que les conditions exprimees soient mutuellement exclu- 
sives : meme si plusieurs sont vraies, seule la premiere d'entre elles entralnera I'instan- 
ciation du modele associe. 

Exemple 

ProgramineConcert.xiiil 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 

<ProgrammeConcert> 
<PageTitre> 

<Entete> 

"Les Concerts d'Anacreon" 

<Date>Samedi 9 octobre 1999, 20H30</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
</Entete> 



<Ensembl e> 
<Nom> 

La Cetra d'Orfeo 
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</Nom> 

<Di rection> 

Michel Keustermans 
</Di recti on> 
</Ensembl e> 

<Interpretes> 
<Role> 
tenor 

<Interprete> Yvan Goossens </Interprete> 
</Role> 
<Role> 

basse 

<Interprete> Conor Biggs </Interprete> 
</Role> 
<Role> 

flute a bee 

<Interprete> Michel Keustermans </Interprete> 

<Interprete> Laura Pok </Interprete> 
</Role> 
<Role> 

viole d'amour 

<Interprete> Vinciane Baudhuin </Interprete> 
</Role> 
<Role> 

oboe da caccia 

<Interprete> Blai Justo </Interprete> 
</Role> 
<Role> 

viole de gambe 

<Interprete> Rika Murata </Interprete> 

<Interprete> Martin Bauer </Interprete> 

<Interprete> Sophie Watlllon </Interprete> 
</Role> 
<Role> 

violone 

<Interprete> Benoit vanden Bemden </Interprete> 
</Role> 
<Role> 

orgue positif et clavecin 
<Interprete> Jacques Willemijns </Interprete> 
</Role> 
</Interpretes> 

<TitreConcert> 

Cantates allemandes 
</TitreConcert> 

<Compos1teurs> 

<CompDs1teur> Bach </Compos1teur> 
<Compos1teur> Telemann </Compositeur> 
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</Compositeurs> 



</PageTitre> 



</ProgramineConcert> 

Nous supposons ici que nous voulons sortir uniquement les noms des musiciens, classes 
par instruments ; de plus, s'il y a deux musiciens pour un instrument donne, les noms 
seront separes par « et», mais s'il y en a trois ou plus, lis sortiront separes par des vir- 
gules, 

II est done necessaire, ici, de compter le nombre d'elements d'un node-set : cela se fait 
tres bien gracea lafonction XPath count( ). 

Voici une premiere version de la feuille de style : 

PrograinineConcert.xsl 

<?xml version="1.0" encoding="LICS-2"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'text' encoding='IS0-8859-r /> 



<xsl itempl ate match="Role"> 



<xsl :value-of select=" . /chi Id: : text( )"/> : 
<xsl :choose> 



<xsl:when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl :when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select="Interprete[2]"/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :val ue-of select="."/><xsl :if test="not(position( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 



<xsl itempl ate match="text( ) "/> 



</xsl :stylesheet> 



Instruction xsl:variable 

Chapitre 5 



Pour un element <roi e> donne, on commence par ecrire le nom de ('instrument, recupere 
en tant que valeur du noeud de type text, enfant direct du <Roie> courant. Ensuite, le 
<xsi :choose> permet de discriminer trois cas possibles : un seul interprete, ou deux, ou 
plus (xsi : otherwise Correspond a trois ou plus, parcequ'il n'y a jamais aucun interprete). 

On remarquera I'utilisation de I'expression XPath interpreteci] , qui est la forme 

COUrtede child: : InterpreteCpositionC ) = 1] . 

Void cequ'on obtient : 
Resultat 

flute a bee 

Michel Keustermans et Laura Pok 
viole d'amour 

Vinciane Baudhuin 

oboe da caccia 

Blai Justo 

viole de gambe 

Rika Murata , Martin Bauer , Sophie Watillon 
violone 

Benoit vanden Bemden 

orgue positif et clavecin 

Jacques Willemijns 

II y a clairement un problemede repartition desespacesblancs, maiscetypedeprobleme 
survi ent necessairement des que I 'on declare une sortie en mode text, comme dans le cas 
present. 

Le moment n'est pas encore venu d'etudier d'une fagon generale les problemes d'es- 
paces blancs en XSLT, nous verrons cela dans le chapitre consacre a I'instruction 
xsi:text (voir Instruction xsl:text, page250), oil nous continuerons I'etude de cet 
exemple afin de rendre le resultat presentable. 



Instruction xshvariable 

Une variable, en XSLT comme dans tout autre langage, est I'association d'un nom et 
d'une valeur. Neanmoins, en XSLT,cette association est indestructible: 11 est impossible 
de changer la valeur d'une variable, une fois qu'on I'a determinee. Nous I'avons deja 
signale plusieursfois, mais 11 est important de rappeler ici que le langage XSLT estun lan- 
gage fonctionnel pur (mais pas complet, dans la mesure ou il ne permet pas de manipuler 
les fonctions comme des donnees), done sans affectation ni effet de bord. En particu- 
lier, les fonctions (qu'elles soient predefinies ou definies explicitement sous forme de 
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modeles nommes) sont des fonctions qui ne modifient en aucune fagon I'etat du proces- 
sus XSLT. 

En XSLT, il est interdit de declarer plusieurs fois la meme variable (11 en est de meme 
dans la plupart des langages), et la seule instruction permettant d'affecter une valeur 
a une variable n'est autre que sa declaration ; la conclusion tombe d'elle-meme : les 
variables ne peuvent pas changer de valeur 

L'instruction xsi :variabie decrite dans cette section est precisement celle qui combine 
declaration et initialisation. 



Bande-annonce 

<xsl :variable nanie="nombreInterpretes" select="count( ./Interprete)" /> 
<xsl :choose> 

<xsl :when test="$nombreInterpretes = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="$nombreInterpretes = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
select= "Interprete [2] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl : val ue-of select="."/><xsl :if test="not(position( ) = 
last())">. </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

Cet exemple montre IMnitialisation d'une variable (nombreinterpretes), et son utilisa- 
tion par appel de sa valeur ($nombreInterpretes). 

Une variable peut aussi etre initial i see par instanciation d'un model e de transformation 
litteral, comme ceci : 

<xsl ivariable naine="inaison"> 
<RDC> 

<cuisine surface='12in2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande bale vitree. 
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</sejour> 

<bureau surface^' 15m2'> 

Bibliotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 

Le model ede transformation peuttres bien etre calcule (etdonc nepas etre entierement 
litteral) : 

<xsl :variable name="mouvement"> 
<insert> 

<Enseinbl e> 

<Nom><xsl :value-of select="NomEnsemble"/></Nom> 

<Di recti onXxsl : val ue-of sel ect="Chef "/X/Di recti on> 

</Ensenibl e> 

<Concert> 

<Date><xsl :value-of sel ect="Date"/></Date> 
<Ville><xsl :value-of select="Ville"/></Ville> 
<Lieu><xsl :value-of select="Sa11e"/></Lieu> 
<Ti treXxsl : val ue-of sel ect="Ti treConcert"/></Titre> 
</Concert> 
</insert> 
</xsl :variable> 

Syntaxe 

xsl :variab1e 

I <xsl :variable name="..." select=" ... expression XPath ... "/> 

Autre possibilite : 

xsl :variab1e 

<xsl :variable name="..."> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :variable> 

L'instruction xsi : variable peut aussi apparaitre comme instruction de premier niveau, 

Regie XSLT typique 

Typiquement, les instructions xsi:variabie seront reparties a volonte dans le pro- 
gramme XSLT comme ceci : 
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<?xml version="1.0" encoding="LICS-2"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method=' . . . ' encoding=' ISO-8859-1 ' /> 

<xsl ivariable name='...' select^'...' /> 

<xsl itempl ate match="..."> 

<xsl ivariable name='...'> 

</xsl :variable> 

</xsl :templ ate> 

<xsl ivariable name='...'> 

</xsl :variable> 

<xsl itempl ate match="..."> 

<xsl ivariable name='...' select^'...' /> 

</xsl itempl ate> 

</xsl istylesheet> 

En effet, une instruction xsi ivariable peut apparaltre a peu pres n'importe ou dans un 
programme XSLT ; on peut meme la trouver comme enfant direct de I'element racine 
<xsi istyiesheet> (dans ce cas, c'est une instruction de premier niveau). Cela ne veut 
pas dire qu'une variable est necessai rement visible (ou utilisable) partout; il y a des 
regies de visibilite, comme en C ou Java (voir Regies de visibilite, page 212). 



Semantique 

En tant qu' instruct! on XSLT, I 'instruction xsi ivariable peut apparaitre dans un modele 
de transformation associe a une regie (voir ci-dessus, Regie XSLT typique, page 181), ce 
qui fait qu'il y a en generai deux model es de transformation a distinguer : un propre a la 
variable elle-mSme, et un propre a la regie X SLT consideree : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl istylesheet xmlnsixsl="httpi//www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl itempl ate match="..."> 

<!-- modele de transformation propre a la regie --> 

<xsl ivariable name='...'> 

<!-- modele de transformation propre a la variable --> 



<!-- fin du modele de transformation propre a la variable --> 
</xsl ivariable> 
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<!-- fin du modele de transformation propre a la regie --> 
</xsl itempi ate> 

</xsl :stylesheet> 

Lorsque le modele de transformation de la regie est instancie, I'instruction <xsi :varia- 
bie>. . .</xsi :variabie> ou <xsi :variabie . . ./> est remplacee par rien (c'est-a-dire 
est supprimee : rien est la valeur de remplacement). Cela ne veut pas dire qu'elle est 
ignoree ; cela veut seulement dire que sa contribution au texte produit dans le fragment 
deresultat, lorsdecetteinstanciation, estnulle: levrai travail sefaiten coulisse. 

En effet, la semantique de devaluation de I'instruction xsi :variabie est celle de I'atta- 
chement d'une valeur a un nom. La valeur est elle-meme I'association d'une donnee et 
d' un type qui permet d' i nterpreter I a donnee. Par exempi e I a donnee 387 sera i nterpretee 
comme la valeur true si le type est booleen, comme la valeur numerique387 si le type est 
Number, et comme la suite de caracteres 3,8,7 si le type est String. La variable prend 
dynamiquement son type d'apres celui de la valeur re§ue : il n'y a pas de typage statique 
comme en C ou Java. 

La valeur peutetreobtenuede deux manieres : 

• soit c'est le resultat de devaluation d'une expression XPath fournieen tant qu'attribut 
select. Rappelons (voir XPath, un langage d 'expressions, page 40) qu'il y a quatre 
types de valeurs possibles pour une telle expression : String, Number, Boolean, et 
Node- set, 

Dans Ce CaS, I 'element <xsl : variable name=" ..." select^" ..."/> doit etre vide (sl 

la balise defermeture <xsi : variable . . .> est presente, il ne doit rien y avoir d'autre 
que d'eventuels espaces blancs entre <xsi :variabie . . .> et </xsi :variabie>). 

• soit c'est un arbre XML, resultat de I'instanciation du modele de transformation 

propre a I'instruction <xsl :variable name=" . . . ">. 

Dans ce cas, I'attribut sei ect=" . . . " ne doit pas etre fourni, 

Un tel arbreXM L s'appelleunTST (Temporary SourceTree), etietypede la variable 
est alors soit node-set en XSLT 1,1 ou plus, soit RTF (Result Tree Fragment) en 
XSLT 1.0. 

Rappelons que cette instanciation se produit lors de I'instanciation du modele de trans- 
formation dans lequel la variable est immergee, si c'est une variable locale ; si c'est 
une variable globale, I'instanciation seproduitjusteavant la premiere etape (voir Trai- 
tementdu document XML source, page 87) du modele detraitement. 

La premiere possibilite nepose pas deprobleme parti culler : avec les expressions XPath, 
on est en terrain connu. Par contre, avec la deuxieme, nous void confrontes a une notion 
nouvelle : qu'est-ce qu'un Temporary SourceTree, et que peut-on en faire? 

Avant de repondre a ces questions, nous allons d'abord voir quelques exemples d'utilisa- 
tion d'une variable dont la valeur provient d'une expression X Path. 
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Variables globales et locales 

Comme beaucoup d'autres langages de programmation, XSLT fait la difference entre 
variable globale et variable locale. Une variable locale est une variable definie a I'inte- 
rieur d'un modele de transformation, alors qu'une variable globale est une variable 
definie a I'exteheur d'une regie XSLT, en tant qu'element XM L enfant direct de I'ele- 

ment <xsl : styl esheet>. 

En regie general e, dans les langages traditionnels, les variables globales n'ont pas bonne 
reputation ; on recommandetoujoursd'en eviter I'usage, car ellerendentplus difficilesia 
maintenance et la comprehension des programmes. C'est du a une raison tres simple : 
une variableglobalepeutetreaffecteedepuisn'importe quel endroitdu programme, ren- 
dant ainsi tres complexes les relations et les roles qui s'etablissent entre les differentes 
parties du programme qui mettent a j our cette variable. 

En XSLT, plus rien de toutga, puisque les variables nesont pas modifiables : 11 n'y a pas 
d' inconvenient parti culier a declarer des variables globales. 

Utilisation d'une variable 

Referencer une variable de nom x, c'est obtenir la valeur attachee au nom x ; cela se fait 
en ecrivant $x. 

Note 

L'expression Sxpeutetre vue comme I'application de I'operateur ?au nom x, renvoyantia valeur de xToutefois, 
cette interpretation s'eloigne de la grammaire XSLT, car$n'estpas un opera teur, etdans I'ecriture $x, un espace 
n'estpas autorise entre le $etle x. 

Dans une expression XPath 

U ne reference de variable peut apparaitre dans une expression X Path, partout ou apparait 
une so us- expression renvoyant I'un des types de base en XPath, c'est-a-dire Number, 
String, Boolean, et Node-set. 

Leseul problemequel'on puisse rencontrer pour mettreen pratique cette affirmation, est 
celui du decoupage d'une expression en sous-expressions. 

Plus precisement, si I'on construit une expression qui ne manipule que des Number, 
String ou Boolean, 11 n'y a aucun probleme : on est dans une situation familiere, iden- 
tique a celle des autres langages courants. On peut utiliser une variable la ou intuiti- 
vement, on en utiliserait une dans un langage comme C ou J ava : 

^ ... select="string-length( concat( $before, $after ) ) - $nbSepar" ... 

Les difficultes surviennent avec les expressions renvoyant un node-set : ces expressions 
sont construites a base de chemi ns de local isation, et la question qui se pose est de savoir si 
un chemi n de localisation est une expression qui peut se decomposer en sous-expressions. 
Si oui, chaque so us- expression peut alors etre remplacee par une reference de variable 
renvoyant la meme valeur. 
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1 1 y a deja un premier element de reponse assez evident : cliaque predicat est une expres- 
sion booleenne, elle-meme decomposable en sous-expressions : toutes ces expressions 
sont remplagables par une reference de variable. 

En dehors des predicats, il n'y a qu'un seul element, dans un chemin de localisation, qui 
peut etre remplace par une valeur, c'est I 'amorce, qui fournit le node-set des noeuds- 
contexte (voir Chemins de localisation, page 62). L'expression ci-dessous est done syn- 
taxiquementcorrecte : 

I Samorce/chi Id: : Interprete/child: :Nom 

et pour qu'elle soit semantiquement correcte, 11 suffit que la variable amorce soit du type 
node-set, autrement dit que la reference a cette variable renvoie un node-set. 

Ailleurs (en dehors des predicats), 11 est impossible de faire figurer une reference de 
variable, car une etape de localisation n'est pas une expression, un axe de localisation 
n'est pas une expression, un determinant n'est pas une expression. 

Tout processeur XSLT doit done refuser (des la decouverte du caractere '$') les expres- 
sions suivantes : 

I /$nomAxe: :Interprete/child: iNom <!-- faux ! --> 
I /child: :$nomEleirent/chi Id: :Noin <!-- faux ! --> 

Dans un motif 

Une reference de variable ne peut jamais intervenir dans un motif, c'est-a-dire dans 
l'expression XPath fournie en tant que valeur de I'attribut match de I'instruction 
xsi itempiate (I 'instruction xsi : key Utilise aussi un motif, de meme que I'instruction 
xsi : number ; ce sont les trois seuls endroits d'un programme XSLT ou un motif peut 
intervenir, et dans ces trois cas, une reference de variable est interdite). 

La raison estquecela pourraitintroduire une circulariteentre la definition devariableet 
I'evaluation du motif ; on verra cela plus en detail a la section Regies de visibility' pour 
les variables globales, page 212. 

Example d'utilisation d'une variable 

Reprenons le programme XSLT vu pour I'instruction xsirchoose (voir Exemple, 
page 176). 

ProgramtneConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transforni" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-r /> 

<xsl : tempi ate niatch="Rol e"> 

*<xsl : val ue-of select="nornial ize-space( ./child: :text( )) "/> : 
<xsl :choose> 
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<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :value-of 
select="Interprete[2]"/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/><xsl :if test="not(position( ) = 
last())">. </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :template> 



<xs1 itempl ate match="text( ) "/> 



</xsl :stylesheet> 

N ous pourrions reecrire ce programme comme ceci : 

ProgramineConcert.xsl 

<?xml version="1.0" encoding="LICS-2"?> 

<xsl istylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" versiDn="1.0"> 



<xsl:output method^'text' encoding='IS0-8859-r /> 



<xsl itempl ate match="Role"> 



*<xsl :value-of select="normalize-space( ./child: :text())"/> : 

<xsl rvariable name="nombreInterpretes" sel ect="count( . /Interprete) " /> 

<xsl :choose> 



<xsl :when test="$nombreInterpretes = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xsl :when test="$nombreInterpretes = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
sel ect=" Interprete [2] "/> 

</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/><xsl :if test="not(position( ) = 
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last())">, </xsl :if> 

</xsl : for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl : tempi ate niatch="text( )"/> 
</xsl :stylesheet> 

La variable nombrelnterpretes est une variable locale, qui n'apporte pas grand-chose au 
programme, il estvrai, etantdonne sa simplicite. M aison entrevoittoutdememel'interet 
qu'il peut y avoir a utiliser une variable au lieu d'une valeur dans une expression : c'est 
d'apporter un confort de lecture appreciable, notamment quand I'expression qui lui a 
donne sa valeur est compi iquee, et que le nom de la variable est suffisamment semantique 
pour eclairer la signification de I'expression en question (il faut ici se rappeler que cequi 
coute Cher, ce n'est pas d'ecrire un programme, mais de le maintenir ; or le maintenir, 
c'est constamment I e rel i re ; c'est pourquoi i I est preferabi e d'opti mi ser I a faci I i te de I ec- 
tured'un programme, qued'en optimiser la facilite d'ecriture). 

II y a par contre un casou une variable est necessai re, c'est eel ui ou on veut manipuler un 
TST, puisque par definition, I'existence d'un TST implique celle d'un modele de trans- 
formation associe a une variable. 

Evaluation d'une variable globaie 

La declaration d'une variable necessite en general ['evaluation d'au moins une expres- 
sion X Path, contenue dans I 'attribut sei ect de la declaration, ou contenue dans le modele 
de transformation associe a la variable si sa valeur est un TST. Or, on salt qu'uneexpres- 
sionXPath ne peut generalement pas etreevalueedansl'absolu : il fautun noeud contexte 
et une liste contexte (pour une variable locale, il n'y a pas de probleme, puisqu'elle est 
declaree dans un modele de transformation, qui est toujours instancie relativement a un 
noeud contexte et une liste contexte). 

La regie est done qu'une variable globaie est evaluee relativement a un noeud contexte 
qui est le noeud racinede I'arbreX M L du document, et avec une liste contexte qui est la 
liste ne contenant que ce noeud. 

Exemple 

Dans cet exemple, on dispose d'un extrait X M L ise d'une base de donnees produits (cata- 
logue) : 

BaseProduits.xml 

I <?xml version="1.0" encocling="UCS-2" standal one="yes"?> 
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<BaseProduits> 
<LesProduits> 

<Livre ref="vernesl" NoISBN="193335" gainme="roman" inedia="papier"> 
<refOeuvre> 

<Ref valeur="200001slni"/> 
</refOeuvre> 

<Prix valeur="40.5" inonnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boileaunarcejacl" NoISBN="533791" ganime="roman" medi a="papier"> 
<refOeuvre> 

<Ref valeur="liatlc.bn"/> 
</refOeuvre> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 

<Enregistrement ref="niarai si" Ref EditeLir="LC000280" 

gamme="violedegambe" media="CD"> 

... sans interet pour I'exemple 
</Enregistreinent> 

<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gainnie="l ecteurCD" 

niarque="HarKar"> 

... sans interet pour I'exemple 
</Materiel> 

<Livre ref="phbeaussantl" NoISBN="138301" gamme="essai " media="papier"> 
<refOeuvre> 

<Ref valeur="vadb.phb"/> 
</refOeuvre> 

<Prix valeur="60" monnaie="FF"/> 
<Prix valeur="8" monnaie="£"/> 
</Livre> 

</LesProduits> 

<LesOeuvres> 

<Oeuvre ref="200001 slm"> 

<Titre> Vingt mille lieues sous les mers </Titre> 
<refAuteurs> 

<Ref val eur="JVernes"/> 
</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="marais.folies"> 

<Titre> Les Folies d'Espagne </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
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</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="vadb.phb"> 

<Titre> Vous avez dit baroque ? </Titre> 

<refAuteLirs> 

<Ref val eur="PhBeaussant"/> 

</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="inarai s .piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 

<refAuteurs> 

<Ref valeur="MMarais"/> 

</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="liatlc.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref val eur="ThNarcejac"/> 
</refAuteurs> 
</Oeuvre> 
</LesOeuvres> 

<!-- ... suite du fichier sans interet pour I'exemple ... --> 
</BaseProduits> 

En supposant que I'etat du catalogue est fourni par les elements contenus dans I'element 
<LesProciuits>, on veut obtenir la liste des titres d'oeuvres correspondant a un livre au 
catalogue. 

Pour chaque <oeuvre>, on va done rechercher si celle-ci correspond a un livre ; si oui, on 
sort letitre de I'oeuvre. 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output inethod='text' encoding=' ISO-8859-r /> 

<xsl :variable name="l i vresAuCatal ogue" 

sel ect="/BaseProduits/LesProduits/Li vre"/> 

<xsl : tempi ate match="Oeuvre"> 

<xsl ivariable name="oeuvreCourante" select="."/> 

<xsl :for-each select="$livresAuCatalogue"> 

<xsl:if test="$oeuvreCourante/@ref = ./refOeuvre/Ref/@valeur"> 

- <xsl :value-of select="$oeuvreCourante/Titre"/> 
</xsl :if> 
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</xsl :for-each> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Pour ce faire, on declare une variable globale iivresAuCataiogue dont la valeur est un 
node-set contenanttous les elements <Livre> de I 'element <LesProduits>. Cette variable 
n'est pas absolument indispensable, car 11 aurait ete possible d'ecrire I'expression 

XPath /BaseProduits/LesProduits/Livre directement COmme valeur d'attribut select 

del 'instruction xsi :for-each. Neanmoins, c'est plus cl air, car plus prochedela semanti- 
que metier, de parler de livre au catalogue, quede /BaseProduUs/LesProduUs/Livre, 

La variable iivresAuCataiogue est une variable globale, done le calcul de sa valeur se 
fait en prenant la racine de I'arbre XM L du document comme noeud contexte. M ais ici, 
I'expression XPath a calculer est un chemin absolu, ce qui rend inutile la connaissance 
du noeud contexte. II aurait toutefois ete possible et equivalent d'ecrire : 

^ <xsl :variable name^'nivresAuCatalogue" select="BaseProduits/LesProduits/Livre"/> 

Cela aurait donne le meme resultat, etant donne le noeud contexte utilise. 

Ceci etant, la suite du programme montre un exemple d'emploi de variable (locale, cette 
fois-ci), dontil serait plus difficile dese passer. En effet, la variable oeuvreCourante per- 
met de garder au chaud le noeud courant, sachant qu'on va bientot le perdre, a cause de 
^instruction xsi :for-each. Dans le modele d'instanciation du xsi :for-each, le noeud 
courant parcourt I'ensemble des livres au catalogue; on n'a done plus la possibilite de 
connaitre I'oeuvre en cours, a moins de I'avoir sauvegardee dans une variable. C'est ce 
qui est fait ici. 

Lecriterede sortie d'un titreestque I'attribut ref de I'oeuvre courantesoitegal a I'attri- 
but valeur de la Ref de la refOeuvre du livre au catalogue courant. 

Etvoici le resultat obtenu : 



II aurait ete possible de prendre le probleme a I'envers : c'est-a-dire d'ecrire une regie 
pour les <Livre>, et d'aller chercher I'oeuvre correspondante : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
1 <xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 




Resultat 



- Vingt mille lieues sous les mers 

- Vous avez dit baroque ? 

- L'ingenieur aintait trop les chiffres 



<xsl:output method^'text' encoding='IS0-8859-r /> 
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<xsl :variable name="l esOeuvres" select="BaseProduits/LesOeuvres/Oeuvre"/> 

<xsl :templ ate niatch="Livre"> 

<xsl : variabl e name=" reference" sel ect=" ./refOeuvre/Ref /@val eur"/> 
- <xsl :value-of 

sel ect=" $1 esOeuvres /Tit re [ 
parent: :Oeuvre[ 

@ref = $reference 

] 

]"/> 
</xsl itempl ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Remarque 

La section qui suitesta rapprocherde la remarque Noeud courant - Noeud contexte, page 89, qui anticipaitsur 
ce qui estexplique maintenant, en montrantqu'il y a lieu de distinguer noeud courant et noeud contexte, meme 
s'ils sontsouventconfondus. 

Le programme est un peu plus simple (pas de xsi :for-each, ni de xsi :if), par contre 
I'une des expressions X Path utilisees est nettement plus compliquee. 

La encore, deux variables sont utilisees, mais aucune n'est reellement necessaire, La 
variable globalepourraitetrefaci I ementsupprimee ; la variable locale un peu moinsfaci- 
lement. Pourquoi ? Remarquons d'abord que des <oeuvre> qui sont des parents de 
<Titre>, 11 n'y en a pas qu'une ; done le processeur XSLT est bien oblige de faire une 
boucleen interne pour recherchercelle qui correspond au criteresur I es references. Cette 
boucle fait evol uer I e noeud contexte, qui va tour a tour designer chacune des oeuvres pos- 
sibles ; et pour chacuned'elles, le predicat [ @ref = $reference ] sera evalue, avec une 
valeur de @ref differente a chaque fois. 

Si I 'on veut se passer de la variable locale reference, 11 faut done ecrire quelque chose du 
genre : 

I parent: :Oeuvre[ @ref = . /refOeuvre/Ref /@val eur ] <!-- faux !! --> 

L'intention est correcte, mais cela ne marche pas, parce que le « . » dans ./refoeuvre/ 
Ref /©valeur designe le noeud contexte (c'est-a-dire self: :node(), en notation longue). 
Or, precisement, commeon vient de le voir, le noeud contexte n'est pas stable dans I 'eva- 
luation du predicat. II faut reellement pouvoir recuperer idle noeud courant, et pour cela, 

II n'y a que deux solutions : soit utiliser une variable (deja vu), soit utiliser la fonction 
predefinie currentc ), qui, comme son nom I'indique, renvoie le noeud courant, 

On pourrait done se passer de variable en ecrivant la regie ainsi : 



<xsl :tenipl ate niatch="Livre"> 
- <xsl :value-of 
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sel ect="/BaseProdui ts/LesOeuv res /Oeuv re/Tit re[ 
parent: :Oeuvre[ 

@ref = current( )/refOeuvre/Ref /@val eur 

] 

]"/> 
</xsl :templ ate> 

Personnel I em ent, je prefere la version avec variable, parce qu'elle me semble plus claire 
etpluslisible. 



Temporary Source Tree 

Un Temporary Source Tree (ou TST) est I'arbreXM L qui resulte de I'instanciation d'un 
modele de transformation. 

Lorsque ce modele de transformation est associe a une instruction <xsi :variabie>, le 
TST represente alors la valeur de cette variable, et c'est done la valeur renvoyee comme 
resultat lorsqu'on reference la variable. 

Remarque 

C'est ici qu'il y a une divergence assez profonde entre XSLT 1.0 etXSLT 1.1 



Plus precisement, cequi est renvoye comme resultat, en XSLT 1.1 ou plus, c'est un node- 
set ne contenant qu'un seul element, a savoir la racine de I'arbre ainsi construit. 

Done, lorsqu'unetellevariableestinstanciee(enXSLT 1.1 ou plus), 11 y aalorsau moins 
deux sources XM L pour le programme XSLT : la premiere, qui existedetoutefa^on tou- 
jours, est I'arbre XML construit d'apres le document source a traiter ; la deuxieme est 
I'arbreXM L qui resulte de I 'instanciation de la variable en question. 



Note 

Par centre, en XSLT 1.0, la valeur d'une variable contenant un TST n'estpas de type node-set, mais d'un type 
special, ResultTree Fragment(RJf), propre aXSLT 1.0, etqui a disparu en XSLT 1.1 (mi Result Tree Fragment 
(XSLT 1.0), page 208). Le fait que ce ne soit pas un node-set interdit I'application d'expressions XPath au TST 
obtenu en referengantia variable. LeTST en XSLT 1.0, n'estdonc pas une source XML a partentiere. 
En XSLT 1.1 ou plus, au contraire, I'arbre XML construit d'apres le document source a traiter, et le TST qui 
resulte de I'instanciation d'une variable contenant un modele de transformation sonttraites a egalite de nature, 
notamment en ce qui concerne la possibilite de leur appliquer des expressions XPath. TST est bien sur une 
denomination qui convient pour le futur de XSLT tel qu'on peut le comprendre au travers du Working Draft 
XSLT 1.1 ou du Working Draft XSLT 2.0, mais il faut savoir que ce n'estpas du tout une denomination officielle 
duW3C. 

Temporary Tree est une nouvelle denomination, initialement proposee par Michael Kay dans la deuxieme edition 
de son ouvrage de reference sur XSLT (parue apres la publication du Working Draft XSLT 1.1), que j'ai legere- 
ment modifiee en Temporary Source Tree, pour mettre en evidence la notion de source, qui me semble ici tres 
importante. Le qualificatif de « temporaire » associe a unTST vientde ce qu'un TST n'a d'existence que durant 
I'execution, etque cette existence estlimitee acelle de la variable a laquelle il estaccroche. 
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Si Michael Kay a ete oblige d'inventerun nouveau terme, c'estparce que le Working Draft XSLT 1 .1 r\'er\ propo- 
sait tout simplement pas. Pourles besoins des explications, Michael Kay a du trouverun nom pour designer un 
arbre constituantia valeurd'une variable, etil a choisi Temporary Tree. Phs tard, Michael Kay estdevenu redac- 
teurde publication de la recommandation W3C pourXSLT 2,0, etie premier Working Draft (20 decembre 2001) 
a introduit la notion de Temporary Tree. 

Personnellement, j'aurais prefereparlerde Primary Source Tree, pour designer I'arbre source provenantdu docu- 
ment source a traiter, et de Secondary Source Trees, pour parler des arbres lies aux variables du programme. 
Neanmoins, comme I'ouvrage de Michael Kay estune reference, etque le Working Group XSL du W3C semble 
lui emboiter le pas, il me semble preferable de ne pas trop m'ecarter de sa proposition, afin de ne pas derouter 
les lecteurs avec une denomination exotique. 

II y a plusieurs vari antes deTST, qui sollicitent plus ou moins le moteur XSLT, mais ces 
variantes ne dependent pas de la version (1.0 ou 1.1 et plus) de XSLT consideree. En 
effet, tant qu'on ne cherche pas a utiliser un TST, mais seulement a le construire, il n'y a 
aucune difference entre X SLT 1.0 et X SLT 1.1. C 'est ce qui etait rageant en X SLT 1,0 : 
on pouvait construire des TST tant qu'on voulait, mais il n'y avait pratiquement rien 
d'interessant pour les manipuler unefois construits. Les variantes que nous allons main- 
tenant voir sont des variantes de construction, et non des variantes d' utilisation. 

TST obtenu litteralement 

La variante la plus simple, et qui sollicite le moins le moteur XSLT, est celle qui ne 
contient aucun element du domaine nominal "xsi : ; le TST est obtenu a partir d'un 
model ede transformation litteral, qui ne contient done aucun element calcule. 

Exemple : 

<xsl :variable name="mai son"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface^' 15m2'> 

Bibliotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 
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Cette variable est done liee a un TST construit a partir d'un fragment de document XML 
parfaitement correct, c'est-a-direbien forme : un seul element racine, et structure d'arbre 
respectee, 

LeTST en question esttoutsimplementl'arbreXML resultant (voir figure 5-2). 



root 



Note : les noeuds text ne 
contenant que des espaces 
blancs ne sont pas montres. 





text 

Evier inox. 
Mobilier 
encastre. 





Lavabo. 




Cumulus 




200L. 



text 

Chemlnee en 
plerre. 
Poutres au 
plafond. 
Carrelage terre 
culte. 
Grande bale 
vltree 



text — 

BIbllotheque 
encastree. 



text 

Palmier en zinc 
figurant le 
desert 



Figure 5-2 

Temporary Source Tree attache a la variable « maison 



Note 

Les noeuds de type fextne contenant que des espaces blancs ne sont pas montres, afin de ne pas surchargeria 
figure ; pour voir ce que cela donne quand on en tient compte, voir figure 5-3. 



M ais la structure d'arbre que doit verifier un TST pour etre correct est moins contrai- 
gnante que celle imposee par le standard XML pour un document XM L. En effet, XML 
impose qu'un document commence par un seul element, appele element racine du 
document (la racine de I'arbreXM L n'a done qu'un seul enfant, qui est I'element racine 
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du document) ; un TST est dispense de cette contrainte : non seulement il peut y avoir 
pi usieurs elements au premier niveau de I'arbre, mais deplus, il peuty avoir du texte non 
bal ise. L a forme la pi us generale d'un TST obtenu litteralement est done tout simplement 
cellequi resultedel'instanciation d'un modelede transformation litteral (voir M odele de 
transformation litteral, page 81), commececi : 

<xsl :variable name="instrunient"> 
viole de gambe 

<Interprete> Rika Murata </Interprete> 
<Interprete> Martin Bauer </Interprete> 
<Interprete> Sophie Watlllon </Interprete> 
</xsl :variable> 

Ici, la racine du TST resultat de I'evaluation de la variable instrument n'a pas un enfant 
unique, comme ce devrait etre le cas pour un document X M L ; il y a en fait sept enf ants 
accroches a la racine du TST («\n » designe unefin de ligne, et «\t » une tabulation) : 

• un premier enfant de type text : \n\tviole de gambe\n\t ; 

• un deuxieme enfant de type element : <Interprete> Rika Murata </Interprete> ; 

• un troisieme enfant de type text : \n\t ; 

• un quatrieme enfant de type element : <Interprete> Martin Bauer </ Interprete> ; 

• un ci nquieme enfant de type text : \n\t ; 

• un Sixieme enfant de type element : <Interprete> Sophie Watillon </Interprete> ; 

• un septieme enfant de type text : \n\t. 

La figure 5-3 donne une representation graphique de cette structure d'arbre ; on pourra 
comparer avec la figure 6-2 qui montre une structure d'arbre XML correct. 



root 



text 

\n\tviole de 
gambe\n\t 




_ text 

Rika 
Murata 



Figure 5-3 

U n TST sans element racine unique. 
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TST calcule 

L orsque le modele de transformation associe a une i nstruction xsi : vari abi e contient des 
instructions XSLT (c'est-a-dire des elements XML prefixes par "xsi :"), le TST n'est 
plusobtenu litteralement, il est calcule. Exemple: 

<xsl ivariable naine="inouvenient"> 
<insert> 

<Ensembl e> 

<Nom><xsl :value-of sel ect="NomEnsembl e"/></Noni> 

<Di recti onXxsl : val ue-of sel ect="Chef "/X/Di recti on> 

</Enseirble> 

<Concert> 

<Date><xsl :value-of sel ect="Date"/></Date> 
<Ville><xsl :value-of select="Ville'7></Ville> 
<Lieu><xsl :value-of select="Salle"/></Lieu> 
<Titre><xsl :value-of select="TitreConcert"/></Titre> 
</Concert> 
</insert> 
</xsl :variable> 

Le TST obtenu en evaluant la variable mouvement est un arbre XML d'element racine 

<insert>, dont la deSCendance est COnStitUee d'elementS fixes (Ensemble, Nom, Date, 

etc.) : lesqueletteestimmuable, maisles contenusdes noeuds text qui lui sont rattaches 
sont calcules, done sont variables en fonction du document X M L qui subit la transforma- 
tion XSLT. 



Note 

lly auraitune autre fagon d'envisagerunTST calcule, oCi le nom des elements sera lent eux-memes calcules, au 
lieu d'etre fixes comme ici. C'est possible a realiser, il faut pour cela utiliser instruction xshelement Nous 
verrons cela dans le chapitre sur les instructions de creation (voir Instruction xshelement, page 272). 

TST-texte 

II y a un cas particulier tres frequent deTST : c'est celui oil leTST ne contient que du 
texte. On peut dire que c'est une forme degeneree, en cesensqu'il n'y a plus vraimentde 
structure d'arbre, mais un simple noeud texte rattache a la racine. LeTST est alors a peu 
pres equivalent a une String. Exemple : 

I <xsl ivariable naine="instrument">saqueboute</xsl :variable> 

On peut comparer cette declaration de variable a eel I e-ci : 

<xsl ivariable naine="instrument" select="'saqueboute"7> 

Concretement, cesdeux declarations sont interchangeables, du moinssi le butestd'avoir 
une variable qui contienne une chaine de caracteres. En effetnous verrons (voirOp«?ra- 
tions sur un TST (XSLT 1.1 ou plus), page 198) qu'un TST peuttoujoursetre converti en 
String ; dans le cas ci-dessus, il est clair que la conversion esttriviale. 
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On remarquera au passage que la declaration avec un modele de transformation est plus 
simple que celle avec I'attribut select, dans le cas ou la valeur a attribuer est une String 
litterale. En effet, pour indiquer une String litterale en tant que valeur d'attribut, il faut 
deux niveaux de guillemets ou apostrophes : 

I <xsl :variable name="instrument" sel ect="saqueboute"/> <!-- faux ! --> 

Dans la declaration ci-dessus, ce n'est pas la String litterale "saqueboute" qui estfour- 
nie comme valeur d'attribut, c'est une expression Xpath qui est la forme courte de 
child: : saqueboute, L'expression va donc selectionner un node-set constitue detous les 
elements filsdu noeud contextequi sontdes <saqueboute> ; il y a donc toutes les chances 
que le resultat soit un node-set vide. Ensuite, si I'on reference la variable en question 
en ecrivant $instrument laou une String estattendue, le node-set (vide) seraconverti en 
String, ce qui donnera une String vide, et donc un resultat inattendu. Ce genre d'erreur 
n'est pas forcement evident a detecter. 

Un TST reduit a un noeud texte n'est pas necessairement obtenu litteralement ; il est 
meme frequent qu'un TST-texte soit calcule. Exemple : 

|<xsl :variable name="result"> 
<xsl :val ue-of select='concat( $repl acement, .)'/> 
</xsl :variable> 

Dans cet exemple, la variable result est associee a un modele de transformation, dont 
I'instanciation donnedonc unTST. CeTST contient une String dont la valeur est fournie 
par une instruction xsi:vaiue-of (dont I'attribut select contient une expression sans 
importance pour les explications) au lieu d'etre litterale comme dans I'exemple prece- 
dent. 

On peut aller plus loin dans la complexity du modele de transformation, sans que cela 
change la structure de TST-texte que I'on obtient lors de I'instanciation, meme si 
cela semble moins evident a la lecture : 

<xsl :variable name="result"> 

<xsl ivariable name="begin" select="$fraginents[position( ) = !]"/> 

<xsl :choose> 

<xsl :when test="starts-with( SunTexte, $givenChar )"> 

<xsl :value-of select="$replacement"/> 

<xsl :val ue-of select="$begin"/> 
</xsl :when> 
<xsl :otherwise> 

<xsl :val ue-of select="$begin"/> 
</xsl :otherwise> 
</xsl :choose> 

<xsl :for-each select="$fragments[position() &gt: 1]"> 
<xsl :val ue-of select='concat( $replaceirent, .)'/> 
</xsl :for-each> 

</xsl :variable> 
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Cette fois, le modele de transformation a instancier est nettement plus complique ; mais 
la variable resui t est toujours associee a un TST compose d'une raci ne a laquelle est rat- 
tache un seul noeud text, contenant une chaine de caracteres qui est ici constituee petit a 
petit par tout un algorithme (sans interet pour les explications qui suivent). 

II faut remarquer que pour faciliter I'ecriture de cet algorithme, une variable auxiliaire 
begin a ete utllisee : etdefait, une instruction xsi :variabie pouvantapparaitre dans tout 
modele de transformation, rien n'interdit qu'elle apparaisse dans un modele de transfor- 
mation lui-meme associe a une declaration de variable. Dans cet algorithme, seules les 
instructions xsi :vaiue-of vont en fin de compte contribuer a constituer la chalne de 
caracteres finale, que I 'on retrouvera comme valeur du noeud textedu TST instancie. 

En effet, lors de I'instanciation de ce modele de transformation, seules les instructions 
xsi:vaiue-of seront remplacees par quelque chose; toutes les autres (xsi :variabie, 

xsi :choose, xsi :when, xsi :otherwise, xsi :for-each) SOnt remplaCeeS par rien (c'est-a- 

dire sont supprimes : rien est la valeur de remplacement). 
Operations sur unTST (XSLT 1.1 ou plus) 
Attention 

Ce qui est dit dans cette section ne s'applique pas a XSLT 1.0, mais aux versions ulterieures. 

UnTST estinstancie lorsdu calcul de la valeur d'initialisation d'une variable possedant 
un modele de transformation ; quand on reference cette variable, on re^oit en retour un 
node-set ne contenant qu'un seul noeud, la racineduTST. 

Ce node-set est alors utilisable partout ouun node-set est attendu, eton peut appliquera 
ce node-set toutes les fonctions XSLT ou expressions/ Path standard. 

En particulier, 11 est assez frequent qu'un TST soitconverti en String, caril est assez fre- 
quent qu'un TST soit utilise dans sa forme degeneree, reduite a un simple texte. Dans ce 
cas, si on fournit un TST alors qu'une String est attendue, 11 y a conversion implicite du 
TST en String. Cette conversion peut intervenir aussi bien dans le cas ou leTST est un 
arbre a part entiere (c'est-a-dire un arbre qui n'est pas reduit a un noeud texte : la conver- 
sion d'un node-set en String s'applique alors), mais c'est moins interessant, done plus 
rarement utilise. 

Dans toute cette section, concernant I'utilisation d'un TST en XSLTl.l ou plus, nous 
fournirons des exemples avec la convention utilisee par Saxon 6.5, le processeur 
XSLT de M ichael Kay. Avec Saxon 6.5, la manipulation de TST au sein d'expressions 
XPath peut se faire sans conversion explicite en node-set, a condition de preciser une 
valeur supeheure a 'i.c (par exemple 'i.i') pour I'attribut version de I'element 

<xsl :stylesheet>, COmmeCeci : 

utilisation transparente d'un TST avec Saxon 6.5 

<xsl rstylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> 
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Exemples d'utilisation d'unTST (XSLT 1.1 ou plus) 

Utilisation d'un TST obtenu litteralement (XSLT 1.1 ou plus) 

UnTST obtenu litteralement sert en general a definir des constantes symbol iques struc- 
turees. Ce sont des constantes parce que rien n'est calcule, et elles sont symboliques 
parce que le nom des ballses employees va pouvoir servir a les referencer, grace a une 
expression XPath adequate. 

I magi nons par exempi e que I 'on veui 1 1 e obteni r une seh e de pages H T |V| L ayant toutes le 
meme en-tete ; on pourrait bien sur declarer plusieurs variables enteteCauche, ent§te- 
centre, et enteteDroi te, et les referencer la Ou on a besoin. |V| ais les avantages d'utiliser 
des variables structurees (comme celles de type struct en C) sont connus ; ici on peut 
structurer ces trois informations en les regroupantdefa^on hierarchique : 

Note 

Obtenirune seriede pages HTML implique bien sur que I'on sache creer plusieurs fichiers de sortie, dontle nom 
est fourni par une expression adequate (de fagon a obtenir par exemple pagel.hbnl, page2.hbnl, etc.). La 
encore, il faudra patienter jusqu'a la version 2.0 du standard XSLT ; en attendant, on continuera a utiliser 
une fonction d'extension disponible (malheureusement sous des formes ti'es diverses) avec les principaux 
processeurs XSLT du marche. Un exemple est disponible a la section PaH:ern n'20 - Generation de documents 
multiples, page 563. 

<xsl :variable name="entete"> 
<hautDePage> 
<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

Void le programme XSLT : 

Concerts .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns : xsl ="http: / /www. w3.org/1999/XSL/Transforni" 

version="l.l"> 

<xsl:output method='htnil ' encoding=' ISO-8859-1 ' /> 



<xsl ivariable name="entete"> 
<hautDePage> 
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<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

<xsl : tempi ate niatch="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /EnteteVX/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<TABLE valign="top" width="100^" height="2%" BORDER="0" > 
<TR> 

<TD align="left"> 
<xsl :va1 ue-of 

sel ect="$entete/hautDePage/gauche"/> 
</TD> 

<TD al ign="center"> 
<xsl :val ue-of 

sel ect="$entete/hautDePage/centre"/> 
</TD> 

<TD al ign="right"> 
<xsl :val ue-of 

sel ect="$entete/hautDePage/droi te"/> 
</TD> 

</TR> 
</TABLE> 

<xsl : apply-templ ates/> 
</body> 
</html> 
</xsl itempl ate> 

<xsl : tempi ate match="Entete"> 

<p> <xsl :val ue-of select="."/> presentent </p> 
</xsl itempl ate> 

<xsl itemplate match="Date"> 

<H1 al ign="center"> Concert du <xsl :val ue-of select="."/> </Hl> 
</xsl itempl ate> 

<xsl itemplate match="Lieu"> 

<H4 al ign="center"> <xsl ival ue-of select="."/> </H4> 
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</xsl :teniplate> 

<xsl itemplate inatch="Ensembl e"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :template> 

<xsl :template inatch="Compositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :val ue-of select="."/> </H3> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

On appliquecettefeuilledestyleau fichier suivant(en faisant abstraction du problemede 
la generation de pages HTML multiples) : 

Concerts .xinl 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 2CH30</Date> 
<Lieu>Chapelle des Llrsules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<NDm> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<NDm> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </NDm> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</CDmpositeur> 
<Composi teur>D. Castel 1 o</Compositeur> 
<CDmpDsi teur>F. RognonK/Composi teur> 
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I</Compositeurs> 
</Concert> 

On obtient le resultat suivant (voir aussi figure 5-4) : 
Concerts .html 

L <html xmlns:xalan="http://xml .apache.org/xalan"> 
I <heacl> 

<META http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
, <title> Les Concerts d’Anacréon </title> 
I </heacl> 

' <body text="black" bgcolor="white"> 

<TABLE BORDER="0" height="2%" wiclth="100%" val ign="top"> 
<TR> 

<TD align="left"> 

musique 
</TD><TD al ign="center"> 

Anacr&eacuteion 
</TD><TD align="right"> 

baroque 
</TD> 

</TR> 
</TABLE> 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002. 20H30</H1> 

</body> 

</html> 



Figure 5-4 

Transformation par 
Concerts.xsl. 



\ Netscape: Les Concerts d'Anacreon \ 



^ ^ id ^ ^ «L 

Back Forward Reload Home Search Netscape Imsqe; 



musique 



Anacreon 



baroque 



Concert du Jeudi 17 Janvier 
2002, 20H30 
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Utilisation d'un TST calcule (XSLT 1.1 ou plus) 

On suppose ici que nous devons maintenir une base de donnees qui contient des en- 
sembles, et des dates et lieux de concerts, en vue d'editer un catalogue de festivals d'ete, 
par exemple. 

Cette base de donnees est mise a jour de differentes manieres ; I'une d'entre elles consiste 
a exploiter trois fichiers qui arrivent periodiquement d'une source exterieure : un fichier 
rawinsert.xmi, qui contient des insertions a effectuer; un ficher rawupdate.xmi, qui 
contient des mises ajour, et rawDeiete.xmi, qui contient des suppressions. 

Lefichier rawinsert.xmi ressemble a cecl : 
rawinsert.xmi 

<?xnil version="1.0" encoding="UTF-16" standalone="yes"?> 
<insertions> 
<Concert> 

<NoniEnsembl e>A deux violes esgal es</NomEnsembl e> 
<Chef>-</Chef> 

<Date>Jeudi 17 Janvier 2002, 20H30</Date> 

<Ville>Angers</Ville> 

<Salle>Chapelle des Ursules</Salle> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 

</TitreConcert> 
</Concert> 
<Concert> 

<NoniEnsembl e>La Cetra d'Orfeo</NomEnsemble> 

<Chef>Michel Keustermans</Chef > 

<Date>Mercredi 20 Mars 2002, 20H30</Date> 

<Ville>Bordeaux</Ville> 

<Salle>Theatre</Salle> 

<TitreConcert> 
Habendmusi ken 

</TitreConcert> 
</Concert> 
<Concert> 

<NoniEnsembl e>Suonare e cantare</NomEnsembl e> 

<Chef>Jean Gai 1 1 ard</Chef> 

<Date>Vendredi 26 octobre 2001, 20H30</Date> 

<Ville>Nantes</Ville> 

<Salle>Musee des Beaux-Arts</Sal le> 

<TitreConcert> 

Madrigali e altre musiche concertate 
</TitreConcert> 
</Concert> 
</insertions> 

On veut faire un fichier synthese de tous les mouvements a realiser, suivant un format qui 
n'est pas forcement celui du fichier montre ci-dessus. 
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Par exemple on voudrait un fichier d'insertions se presentant comme ceci : 

insert.xml r 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Mouvements> 
<insert> 
<Ensembl e> 

<Nom>A deux violes esgales</Nom> 
<Di recti on>-</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>Jeudi 17 Janvier 2002. 20H30</Date> 
<Ville>Angers</Ville> 
<Lieu>Chapelle des Ursules</L1eu> 
<Titre> 

Folies d'Espagne et diminutions d'ltalie 
</Titre> 
</Concert> 
</insert> 
<insert> 
<Ensembl e> 

<Nom>La Cetra d'0rfeo</Nom> 
<Di recti on>Michel Keustermans</D1 recti on> 
</Ensembl e> 
<Concert> 

<Date>Mercredi 20 Mars 2002. 20H30</Date> 

<Ville>Bordeaux</Ville> 

<Lieu>Theatre</Lieu> 

<Titre> 

Habendmusi ken 
</Titre> 
</Concert> 
</insert> 
<insert> 
<Ensembl e> 

<Nom>Suonare e cantare</Nom> 
<Di recti on>Jean Gail 1 ard</Di recti on> 
</Ensembl e> 
<Concert> 

<Date>Vendredi 26 octobre 2001. 20H30</Date> 

<Ville>Nantes</Ville> 

<Lieu>Musee des Beaux-Arts</Lieu> 

<Titre> 

Madrigali e altre musiche concertate 
</Titre> 
</Concert> 
</insert> 
</MoLivements> 

La transformation de structure peut se faire tres simplement : il suffit de « cabler » la 
nouvelle structure dans un modele de transformation. L'instanciation de ce modele de 
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transformation pour chaque <concert> rencontre dans le fichier donne rawinsert.xmi 
donnera le resultat souhaite : 

preparelnsert.xsl 

<?xml version="1.0" encocling="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xnil ' encoding=' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 

<Mouvements> 

<xsl :apply-teinplates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl itemplate match="Concert"> 

<xsl ivariable name="mouvement"> 
<insert> 

<Enseinbl e> 

<Nom><xsl :value-of select="NomEnsemble"/></Nom> 

<Di recti onXxsl : val ue-of sel ect="Chef "/X/Di recti on> 

</Ensembl e> 

<Concert> 

<Date><xsl :value-of sel ect="Date"/></Date> 
<Ville><xsl :value-of select="Ville"/></Ville> 
<Lieu><xsl :value-of select="Salle"/></Lieu> 
<Ti treXxsl : val ue-of sel ect="Ti treConcert"/></Titre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Soyons honnetes, si on lance la feuillede style ci-dessussurle fichier rawinsert.xmi, le 
resultat ne sera pas aussi beau que celui montre ci-dessus (fichier insert. xmi) ; en fait, 
void qu'on aura : 

insert.xml 

<?xml version="l .0" encodings" ISO-8859-1 "?><Mouvements><insert><Enseinbl e><Nom> 
A deux violes esgales</Noin><Direction>-</Direction></Ensemble><Concert><Date> 
Jeudi 17 Janvier 2002, 20H30</Date><Ville>Angers</Ville><Lieu>Chapelle des Ursules 
</Lieu><Titre> 

Folies d'Espagne et diminutions d'ltalie 
</Titre></Concert></insert><insert><Ensembl e><Noin>La Cetra d'Orfeo</Nom> 
<Di rection>Michel Keustermans</Direction></Ensemble><Concert><Date>Mercredi 20 mars 
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2002. 20H30</Date><Ville>Bordeaux</Ville><Lieu>Theatre</Lieu><Titre> 
L Habendmusi ken 

I </Titre></Concert></insert><insert><Ensemble><Nom>Suonare e cantare</Nom> 

' <Di rection>Jean Gai 1 1 ard</Di rectionX/Ensembl e><Concert><Date>Vendredi 26 octobre 

2001. 20H30</Date><Ville>Nantes</Ville><Lieu>Musee des BeaLix-Arts</Lieu><Titre> 
I Madrigali e altre musiche concertate 

I </Ti tre></Concert></insert></Mouvements> 

Pour obtenir un resultat lisible, il faut ajouter I'attribut indent='yes' dans ('instruction 
xsi :output, commececi : 

I <xsl:output method^'xml ' encodings' ISO-8859-r indent^'yes' /> 

Ceci dit, I 'example que nous venons de montrer n'est pas specifique a la version 1.1 ou 
plus de XSLT ; en effet leTST est utilise comme cible de I 'instruction xsi :copy-of, ce 
qui n'est pas interdit par XSLT 1.0. Nous verrons qu'une operation sur un TST est pos- 
sible en XSLT 1.0, a condition qu'elle soit applicable a une String (voir Operations sur 
un RTF (XSLT 1.0), page 209) ; or uneString peutetre copiee par un xsi :copy-of. 

Mais il est evident qu'un programme tel que celui montre ci-dessus, est susceptible 
d'evoluer, etqu'il est probable qu'un jour ou I'autre, on aura besoin d'ecrire : 

<xsl :copy-of select="$mouvement/insert/Ensemble"/> 

en plusde: 

<xsl :copy-of sel ect="$mouvement"/> 

Cettefois, le programme sera incompatible avec la version 1.0 deXSLT, et il faudra alors 
declarer la valeur 1.1 pour I'attribut version de la declaration <xsi :styiesheet>, si tou- 
tefois on utilise le processeur Saxon 6.5. 

Utilisation d'un TST-texte pour le calcul de la valeur par defaut d'un attribut 



Remarque 

Ce qui estditici est compatible avec XSLT 1.0, parce que leTST utilise est seulementconverti en String, ce qui 
estpermis en XSLT 1.0, comme on le verra plus loin ( voir Operations surun RTF (XSLT 1.0), page 209). 



En XM L, il est possible, dans certaines conditions, qu'un element ait un attribut faculta- 
tif ; s'il est omis, I 'application de traitement du fichier XM L est censee pouvoir affecter 
une valeur par defaut a cet attribut, si toutefois c'est necessaire. 

Pour faire cela en XSLT, rien de plus simple: il suffit de declarer une variable avec 
modele de transformation, contenant un calcul de valeur par defaut, Exemple : 

produits.xml 

<?xml version="1.0" encoding="UTF-16"?> 

I<LesProduits> 
<Livre ref="vernesl" NoISBN="193335" gamme^'roman" inedia="papier"> 
<refOeuvre> 
<Ref valeur="200001slm"/> 
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</refOeuvre> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" inonnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" gamrtie="roman" media="papier"> 
<refOeuvre> 

<Ref valeur="liatlc.bn"/> 
</refOeuvre> 
<Prix val eur="30"/> 
</Livre> 
</LesProdLiits> 

Ici, on peut imaginer que I'attribut monnaie de I 'element <Prix> soit facultatif ; s'il n'est 
pas fourni, sa valeur sera « FF » par defaut. Voici comment proceder : 

produits.xsl 

<?xnil version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl : tempi ate match="Livre"> 

<xsl ivariable name="monnaie"> 
<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :value-of select="Prix/@monnaie"/> 
</xsl :when> 

<xsl :otherwise>FF</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

ref: <xsl :value-of select="@ref "/> 
prix: <xsl :value-of 

select="Prix/@valeur"/> <xsl :val ue-of select="$monnaie"/> 
</xsl :template> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

A pres execution, on obtient ceci : 
Resultat 

ref: vernesl 
prix: 40.5FF 



ref: boi 1 eaunarcejacl 
prix: 30FF 
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Dans le modele de transformation de la variable monnaie , on notera I'alternative pour 
instancier leTST : dansune brancheon instancie une chaine de caracteres provenant de 
devaluation d'une expression, dans I'autre on instancie une valeur litterale (FF). Letest 
effectue, qui permet de savoir si la chaine de caracteres Prix/@monnaie est vide ou non, 
selectionne une des deux branches. 

Result Tree Fragment (XSLT 1.0) 

Attention 

Ce qui est dit dans cette section s'applique aXSLT 1,0 ; on peutignorerdonc toutce qui suit si on travaille avec 
un processeurXSLT conforme aux propositions du XSLT Worl<ing Draft 1,1 ou 2,0, 

En XSLT 1.0, un modele de transformation associe a un element <xsi :variabie> ou 
<xsi:param> est un arbre XML, qu'on peut continuer a appeler un TST (Temporary 
SourceTree) ; jusque la, aucune difference avec ce qu'on a vu. La ou tout bascule, c'est 
que leTST n'est pas de type node-set, mais d'un type special, appele RTF (Result Tree 
Fragment). 

Un Result Tree Fragment (ou RTF) est un cinquieme type de donnee XSLT, qui vient 
done s'ajouter aux quatre types XPath que sont les types String, Number, Boolean et 
N ode- set. 

En XSLT 1.0, la notion de node-set est exclusivementreservee aux ensembles constitues 
de noeuds issus de I'arbre XM L du document source XM L a traiter. Les arbres XML 
provenant de I'instanciation d'un modele de transformation associe a une variable ne 
peuvent pas donner lieu a un node-set : ils sont comme pestiferes, et affubles d'un nom 
bizarre qui acheve leur mise a I 'ecart, 

Note 

RTF veutdire ResultTree Fragment, Or un RTF n'estpas un fragment d'arbre, mais un arbre, etil n'a pas force- 
ment a voir avec le document resultat de la transformation XSLT : c'est en cela que le nom RTF est un peu 
bizarre, 

Cette mise a I'ecart n'est pas seulement genante dans le principe, eile I'est aussi concre- 
tementcar elleempeche pratiquementtoute manipulation XPath sur un RTF. Or un arbre 
sans XPath, c'est comme un parachute sans suspentes: pas tres commode a utiliser, 
Impossible par exemple de recuperer la surface du bureau, quand on a ecrit : 

<xsl ivariable naine="inaison"> 
<RDC> 

<cuisine surface='12in2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 
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<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface^' 15m2'> 

Bibliotheque encastree. 
</bureau> 

<jardin surface='150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl :variable> 

alors qu'une expression du genre : 

I <xsl :val ue-of sel ect="$mai son/RDC/bureau/@surf ace"/> 

semble pourtant parfaitement plausible et utile. Elle n'a que le tort d'etre interdite. 

On volt done que la fonction d'extension, disponible avec la plupart des processeurs 
XSLT (Xalan, Saxon, Xt...), permettant la conversion entre un RTF et un node-set ne fait 
que reparer une injustice, et n'a pas grand travail a effectuer vu I'extreme ressemblance 
entre un RTF -set et un node-set. 

Cela etant, la future version XSLT2.0 de XSLT va operer sa revolution, et abolir ces 
arbres de seconde classe que sont les RTF ; un modele de transformation lie a une va- 
riable sera considere comme un nouveau et veritable document source, et une reference a 
cette variable renverra un node-set, auquel on pourra appliquer toutes les expressions 
XPath que I'on voudra. 

Operations sur un RTF (XSLT 1.0) 

Que peut-on faire d'un RTF ? Le langage XSLT (1.0) n'autorise que deux operations 
possibles sur un RTF : 

• On peut leconvertir en String, par application de la fonction standard stringc ), impli- 
citement ou explicitement ; la conversion est implicite si leRTF figure comme valeur 
de I'attribut select de I 'instruction xsi :vai ue-of. 

Dans ce cas, la valeur du RTF convertie en String est egale a la concatenation de tous 
ses noeuds de type text, pris dans I'ordre de lecture du modele de transformation 
duquel le RTF provient. 

• On peut aussi le copier tel quel dans le document resultat de la transformation, en le 
donnant comme valeur de I'attribut select de I 'instruction xsl : copy-of . 

En resume, une operation est possible sur un RTF a condition qu'elle soit possible sur 
une String. 

A part ces deux operations prevues dans le standard, les principaux processeurs X SLT du 
marche offrent une fonction d'extension permettant de convertir un RTF en node-set, ce 
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qui ouvre considerablement le champ des possibilite d'utilisation, dans la mesure ou une 
variable associee a un RTF calcule peut alors etre consideree comme une structure de 
donnees exploitable a I 'aide d'expressions XPath adequates, comme I 'est un TST en 
XSLT 1.1. Tant qu'on n'a pas cettefonction de conversion, on peut certes creer la struc- 
ture de donnees, maison ne peut guere I 'exploiter, cequi est tout dememeassez rageant, 
11 faut bien le reconnaitre. 

Pour montrer comment utiliser une telle fonction de conversion, nous allons reprendre 
I'exemple vu a la section Utilisation d'un TST obtenu litteralement (XSLT 1.1 ou plus), 
page 199. 

L e programme est legerement transforms, comme ceci : 
Concerts.xsl 

I <?xml version="1.0" encoding="UCS-2"?> 
<xsl :stylesheet 

xmlns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
xmlns:xalan="http://xinl .apache.org/xalan" 
version="1.0"> 

<xsl:output inethod='html ' encodings' ISO-8859-r /> 

<xsl :variable name="entete"> 
<hautDePage> 
<gaLiche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl :variable> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /Entete"/></titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<TABLE valign="top" width="100%" height="2%" BORDER="0" > 
<TR> 

<TD align="left"> 
<xsl :val ue-of 

sel ect="xal an :nodeset($entete)/hautDePage/gauche"/> 
</TD> 

<TD al ign="center"> 
<xsl :val ue-of 
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select="xal an :nodesetC$entete)/hautDePage/centre"/> 
</TD> 

<TD al ign="right"> 
<xsl :value-of 

select="xal an :nodeset($entete)/hautDePage/droite"/> 
</TD> 

</TR> 
</TABLE> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :teniplate> 

<xsl itemplate match="Entete"> 

<p> <xsl :value-of select="."/> presentent </p> 
</xsl :teniplate> 

<xsl itemplate inatch="Date"> 

<H1 al ign="center"> Concert du <xsl :value-of select="."/> </Hl> 
</xsl :teniplate> 

<xsl itemplate match="Lieu"> 

<H4 al ign="center"> <xsl :value-of select="."/> </H4> 
</xsl :template> 

<xsl itemplate inatch="Ensembl e"> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :template> 

<xsl :teinplate inatch="Conipositeurs"> 

<H3 al ign="center"> Oeuvres de <br/> <xsl :val ue-of select="."/> </H3> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

On remarquera la fagon dont on procede pour obtenir I'autorisation d'utiliser unefonc- 
tion d'extension : il faut declarer un nouveau domaine nominal, en plusdecelui d'XSLT, 
abrege en "xsi :". En I'occurrence, avec le processeur Xalan, le domaine nominal est 

http://xml .apache.org/xalan ; on choisit une abreviation (icl "xalan:"), et a I'appel, 

le nom de la fonction doitetre qualifie par I'abreviation choisie : 

I <xsl :value-of sel ect="xal an : nodeset ($entete)/haLitDePage/droi te"/> 
Note 

Avec Saxon, on aurait a declarer le domaine nominal http ://icl.com/saxon. 
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Regies de visibilite 

Les regies de visibilites indiquent si telle reference a une variable est autorisee, en fonc- 
tion del'endroitou est declaree la variable, etdecelui ou elleestreferencee. 

Regies de visibilite pour les variables globales 

Pour les variables globales, les regies sont tres simples : une variable globale peut etre 
referencee de n'importe quel endroit du programme XSLT, a la seule condition que la 
declaration ne soit pas circulaire (c'est-a-dire que la declaration ne contienne pas, direc- 
tement ou indirectement, de reference a eile-meme) : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl ivariable naine="val eur"> 

<xsl :value-of select="$valeLir"/> <!-- interdit ! --> 
</xsl :variable> 

<xsl itempl ate match="TitreConcert" > 
</xsl :templ ate> 

<xsl itempl ate match="Concert"> 
</xsl itempl ate> 
</xsl istylesheet> 

instruction ci-dessus xsi :vaiue-of avec son attribut seiect="$vaieur" est interdite^ 
(elle introduit une circularite directe) ; de meme, le programme ci-dessous pourrait etre 
incorrect : 

<?xml version="1.0" encoding="LICS-2"?> 

<xsl istylesheet xmlnsixsl="httpi//www. w3.org/1999/XSL/Transform" versiDn="1.0"> 

<xslioutput method^'text' encoding='IS0-8859-r /> 

<xsl ivariable name="truc"> 
<xsl lapply-templates /> 
</xsl ivariable> 

<xsl itempl ate match="TitreConcert" > 
</xsl itempl ate> 

<xsl itempl ate match="Concert"> 



1. mais de la memefa9on, il nefaut pas oublier que c'est interdit defumer en jouant du hautbois. 
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<xsl :val ue-of select="$valeur"/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Remarquez ici le modele de transformation de la variable true : il contient une instruc- 
tion xsi :appiy-tempiates. Or, une variable globale estevaluee avec la racine de I'arbre 
X M L du document comme noeud contexte : I'instruction xsi :appiy-tempiates va done 
relancer le moteur XSLT sur I'element fils de cette racine, puis eventuellement, sur 
d'autres elements, si d'autres instructions xsi :appiy-tempiates sont rencontrees. Rien 
ne dit que dans ce processus, le moteur selectionnera la regie <xsi :tempiate match= 
"Concert">. Si elle n'est pas selectionnee, le programme ci dessus est correct, du moins 
quant a I 'evaluation de la variable true ; si elle est selectionnee, unecircularite indirecte 
apparait, et le programme est alors incorrect. 

Eviter les circularites est la seule precaution a prendre dans la declaration et la manipula- 
tion de variables globales ; en particulier, il n'est pas interdit de referencer une variable 
dont la declaration n'intervientqu'un peu plus loin dans I'ordre de lecture du document : 
c'est ce qu'on appelle communement une reference avant dans les autres langages. Les 
references avant sont interdites en C, autorisees en Java, et aussi en XSLT, mais unique- 
ment pour les variables globales. 

Une autre source de circularite potentielle serait la presence d'une reference de variable 
dans un motif. C'est pour cette raison que c'est interdit, ainsi que nous I'avons deja 
signale (voir Dans un motif, page 185). 

Si celaetait possible, on pourraitecri re quelque chose comme ceci : 

<?xnil version="1.0" encocling="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl ivariable name="amorce"> 

<xsl lapply-templates /> 
</xsl :variable> 

<xs 7 : template niatch= "$amorcel ch 11 d: : Interprete/ ch 1ld: : Norn" > 

</xsl itempl ate> 
<xsl : tempi ate match="..." > 
</xsl :templ ate> 
</xsl :stylesheet> 

II serait alors impossible d'evaluer le motif sans connattre la variable ; mais revaluation 
de la variable entraine une recherche de concordance de motif, qui ne peut s'effectuer 
tant que la variable n'est pas connue... 
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Regies de visibilite pour les variables locales 

Pour les variables locales, les regies sontun peu plus contra! gnantes, puisque les referen- 
ces avant sont interdites (la circularite directe ou indirecte etant absurde, elle reste evi- 
demment interdite). Un programme XSLT est un document X M L, et en tant que tel, un 
arbre XM L lui est associe. Ce qui veut dire que la structure d'un programme XSLT est 
une structure deblocsjuxtaposesou imbriquesa volonte. Les regies de visibilite, pour les 
variables locales, sont celles qui sont traditionnellement adoptees pour les langages a 
structure de blocs : une vari able declaree dans un bloc nepeutetre referencee que dans le 
meme bloc, ou dans n'importe quel bloc plus interne (cette regie est neutre vis-a-vis des 
references avant : interdiction ou I'autorisation des references avant vient en plus), 

Remarque 

L'interdiction des references avant est un peu contradictoire avec la nature declarative et fonctionnelle du 
langage XSLT, En tout cas, elle n'etait pas necessaire ; on peut penser qu'elle a ete decidee parce qu'elle n'a 
rien de tres contra ignant, et qu'elle facilite notablementia lecture du programme. 

Les regies de visibilite des variables locales sont done une combinaison de la regie des 
blocs et de celle des references avant; cela peut se resumer graphiquement, en faisant 
apparaitre les instructions XSLT comme des blocs numerotes, et en montrant, pour une 
declaration de variable donnee, quels sont les blocs oil une reference a cette variable est 
autorisee (voir figure 5-5). 

Terminons en remarquantque I'allusion aux langages a structure de blocs n'est pas abso- 
lument necessaire pour decrire les regies de visibilite en XSLT : XPath donne evidem- 
ment tout le vocabulaire adequat pour decrire ces regies sans parler de bloc. II suffit de 
dire que si on prend comme noeud contexte le noeud contenant la declaration d'une va- 
riable locale, alors les noeuds oil une reference a cette variable est autorisee sonttous les 
noeuds de I 'axe f oi i own ng-si bi i ng, ainsi que tous leurs descendants. 

Conflits de noms de variables 

II y a conflit de nom, si a un endroit donne d'un programme XSLT, 11 y a au moins deux 
variables de meme nom simultanement visibles. 

Un conflit de nom entre deux variables globales est interdit, de meme qu'entre deux 
variables locales. 

M ais un conflit de nom est autorise entre une variable globale et une variable locale. 
Dans ce cas, la variable locale masque la variable globale ; la valeur de la variable glo- 
bale n'est done pas disponiblea I'endroit du conflit. 
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Instruction xshparam 

Les instructions xsi :van"abie et xsi :param sont deux instructions voisines, tant sur le 
plan syntaxique que semantique. L'une declare une variable, et I'autre un parametre, 
c'est-a-dire quelque chose d'assez semblable a un argument formel de fonction dans un 
langage comme C ou Java, La difference essentielle entre variable et parametre est 
qu'une variable est declaree par une instruction qui lui donnesa valeur, alors qu'un para- 
metre est declare par une instruction qui ne lui donne qu'une valeur par defaut, 

Les parametres suivent exactement les memes regies de visibilite que les variables, et les 
memes conflits de noms peuvent survenir, avec exactement les memes consequences et 
conclusions que ceux qui concernent des variables. 

De plus, etant donne la similitude entre variable et parametre, des conflits de noms croi- 
ses peuvent apparaitre, mettant en jeu une variable et un parametre, et pas seulement 
deux variables ou deux parametres. M ais a nouveau, la nature exacte (variable ou para- 
metre) des elements mis en jeu n'intervient pas ici, et ce cas se ramene a un conflit de 
nom entre deux variables. 

Bande-annonce 

Debut d'une feuille de style 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 

xinlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 
<xsl:param name="monnaieUsuelle" sel ect=" ' FF"7> 



<xsl :value-of select="$monnaieUsuelle"/> 



Lancement du processeur XSLT 

I Java com. icl .saxon. Stylesheet 
-0 produits.txt produits.xml produits .xsi monnaieUsuelle^DM 

La valeur du parametre monnaieusueiie est fourni dans la ligne de commande lors du 
lancement du processeur X SLT. La valeur ff associee a ce parametre dans le programme 
XSLT n'estqu'une valeur par defaut. 

Syntaxe 

xsi iparain 

<xsl:param name="..." select=" ... expression XPath ... "/> 
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Autre possibilite : 

xsl :parain 

<xsl :param naine=" . . . "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl :param> 

instruction xsi :param peut apparaitre comme instruction de premier niveau. 
On voitquexsi :variabie etxsi :param partagentla memesyntaxe. 



Semantique 

Un parametre peut etre local ou global. S'il est local, il joue le meme role qu'un argu- 
ment formel de fonction en C ou Java. S'il est global, 11 joue le meme role qu'un 
argument formel de la fonction main en C ou Java, c'est-a-direqu'il permet de recuperer 
les arguments qui ont pu etre fournis lors du lancement du programme XSLT (mais le 
standard XSLT ne sped fie pas de quelle fa^on on peut transmettre des arguments au pro- 
gramme XSLT lors de son lancement). 

La valeur associee a un parametre lors desa declaration est une valeur par defaut, qui ne 
sera prise en comptequesi aucune valeur n'estfournie lors del'appel. 

Utilisation d'un parametre global 

Reprenons I'exemple vu a la section Utilisation d'un TST-texte pour le calcul de la 
valeur par d«?fautd'un attribut, page 206, danslequel unevariableservaitafairel'expan- 
sion de la valeur par defaut d'un attribut. Nous voulons maintenant que la monnaie par 
defaut ne soit plus codee en dur dans le programme, mais qu'elle soit parametrable en 
fonction des executions : 

produits.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

vers1on="1.0"> 

<xsl:output method='text' encoding='IS0-8859-l' /> 

<xsl:param name="monnaieLlsuelle" sel ect=" ' FF' "/> 

<xsl itemplate match="Livre"> 

<xsl ivariable name="monnaie"> 
<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :value-of select="Prix/@monnaie"/> 
</xsl :when> 
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<xsl :otherwise> 

<xsl :value-of select="$inonnaieUsuelle"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

ref: <xsl :value-of sel ect="@ref "/> 
prix: <xsl :val ue-of 

select="Prix/@valeur"/> <xsl :val ue-of select="$monnaie"/> 
</xsl :templ ate> 



<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Si on lance I'execution decettefeuillede style sans sepreoccuperdefournir une valeur 
au parametre monnaieusueiie, on obtient le meme resultat que precedemment (voir Uti- 
lisation d'un TST-texte pour le calcul de la valeur par defaut d'un attribut, page 206) : 



Cela est dfl a ce que le parametre monnaieUsueiie a pris sa valeur par defaut (« FF »), 
etant donne qu'on ne lui a pas donne de valeur expliciteau lancement du programme. 

Pour fournir une valeur au parametre monnai eusuei i e, il faut se reporter a la documenta- 
tion du processeurXSLT que I 'on utilise. Un cas simple d' utilisation est eel ui ou on lance 
le programme via une ligne de commande sur le systeme bote (commande DOS sous 
Windows, commande sbell sous Unix, etc.) ; dans ce contexte, la documentation fournie 
avec Saxon nousditceci : 

Using Saxon from the Command Line 

java com. icl .saxon. Stylesheet [options] source-document stylesheet [params...] 

The options must come first, then the two file names, then the params. 

A param takes the form name^value, name being the name of the parameter, and value 
the value of the parameter. These parameters are accessible within the stylesheet 
as normal variables, using the $name syntax, provided they are declared using a 
top-level xsl:param element. If there is no such declaration, the supplied parameter 
value is silently ignored. 

II suffit done de faire comme indique, c'est-a-dire de lancer le programme comme ceci 
(la ligne de commande est bien sur d'un seul tenant, meme si la mise page la coupe en 
deux) : 




Resultat 



ref: vernesl 
prix: 40.5FF 



ref: boileaunarcejacl 
prix: 30FF 
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Ligne de comtnande 

I Java com. icl .saxon. Stylesheet -o produits.txt produits .xml produits.xsl 
monnaieUsuelle^DM 

Et voila le travail : 
Resultat 

ref: vernesl 
prix: 40.5FF 

ref: boi 1 eaunarcejacl 
prix: 30DM 

Ce qui correspond bien a ce qu'on attendait. 

Saxon n'est pas le seul processeur du marche ; mais tous fournissent un moyen de definir 
des valeurs de parametres via la ligne de commande ; par exemple, avec Xalan, on aurait 
a lancer la commande suivante, pour obtenir le meme resultat : 

Ligne de comtnande 

I Java org. apache. xalan. xslt. Process -IN produits. xml -XSL produits.xsl -OUT 
produits.txt -PARAM monnalelisuelle DM 

Utilisation d'un parametre local 

L'utilisation d'un parametre local est vraiment tres differente de celle d'un parametre 
global. On I'a vu, les parametres globaux serventa recuperer des arguments de la ligne 
de commande, fournis sous forme de pal res (nom, valeur), d'une maniere qui n'est 
d'ailleurs pas specifiee par le standard XSLT, Si I'on n'a pas pour but une quelconque 
recuperation d'argument, mieux vaut, dans ce cas, utiliser une variable globale qu'un 
parametre global, car l'utilisation d'un parametre global suggere I'intention de trans- 
mettre un argument. 

Rien detoutcela pour un parametre local, qui, nous I'avonsdit, correspondrait plutota la 
notion d'argument formel de fonction, meme si la notion de fonction n'existe pas a pro- 
prement parler en XSLT. 

II est done impossible d'aller plus loin dans la comprehension des parametres locaux, 
sansallerfaireun tour du c6te des modules nommes (<xsi : tempi ate name=". . .">) etdes 
appels de modeles nommes (<xsi :caii -tempi ate name=". . .">), que nous allons voir 
maintenant, 
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X SLT est un langage de transformation d'arbre. A ce titre la structure la plus importante 
du langage est sans aucun doute la regie, qui, associeeau moteur de transformation, per- 
met la transformation effective d'un arbreou d'une partie d'arbre. 
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Une regie est associee a un modele de transformation, qui consiste (en general) en une 
Sequence de plusieurs transformations elementaires (par exemple, un xsl:value-of, suivi 
d'un autre xsl:value-of, suivi d'un xsl:if). Certaines sequences peuvent revenir a I'iden- 
tique dans plusieurs regies differentes, de meme que dans un programme en C, par 
exemple, une meme sequence d'instructions peut se retrouver a differents endroits du 
traitement. Dans les deux cas, I 'idee naturelle est alors de factoriser la sequence com- 
mune, etde lui donner un nom ; cela donneunefonction en C ou en Pascal, et un modele 
nomme en XSLT. 

Note 

La factorisation de code est la motivation la plus ancienne pourjustifier I'emploi defonctions ; 11 est evident qu'il 
y en a d'autres, ne serait-ce que le decoupage d'un code monolithique en petites unites semantiques plus faciles 
acomprendre eta maintenir. Cela vautbien suraussi pourXSLT. 

Un modele nomme et une regie s'expriment tous les deux a I'aide d'une instruction 
xsi :tempiate ; ce qui les differencie d'un point de vue syntaxique, c'est que pour une 
regie, on specifie un attribut match=" . . . ", alors que pour un modele nomme, on specifie 
un attribut name =" . . . ", eton ne specifie pas d'attri but match. M ais rien n'interditde spe- 
cifier les deux attributs match et name simultanement : dans ce cas, on a une regie nom- 
mee, c'est-a-dire un hybride qui peut etre selectionne comme une regie, ou appele 
comme un modele nomme, 

Bande-annonce 

Le modele nomme ci-dessous instancie un textefourni en parametre, en I'accompagnant 
d'un saut de ligne et d'un tiret, 

Nom.xsl 

f <?xirl version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl : tempi ate name="instancierTexteAvecTi ret"> 

<xsl:param name="texte"/> 

- <xsl :val ue-of sel ect="$texte" /> 
</xsl :templ ate> 

<xsl :templ ate match="Nom"> 

<xsl :cal 1 -tempi ate name="instancierTexteAvecTi ret"> 
<xsl :with-param name="texte" select="."/> 

</xsl :call-template> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 



</xsl :stylesheet> 
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Concert.xml 

<?xml version="1.0" encocling="UTF-16" standalone="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapel le des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<NDni> Benjamin Perrot </NDni> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 
<CDmpositeur>M 
<Compositeur>D 
<Compositeur>F 
</Compositeurs> 

</Concert> 

Leresultatobtenu estdonne ici en anticipant sur la procliaine instruction qui sera vueun 
peu plus loin (voir la section Instruction xsl:call-template, page 229). 

Resultat 

- Jonathan Dunford 

- Sylvia Abramowicz 

- Benjamin Perrot 



. Marais</Compositeur> 
. Castell o</Compositeur> 
. Rognoni</Compositeur> 
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Syntaxe 

Modele notnme xsl : tempi ate 

<xsl itempl ate naine="..."> 

<!-- arguments formels du modele nomme --> 

<!-- fin des arguments formels du modele nomme --> 
<!-- corps du modele de transformation --> 
... instructions ... 

<!-- fin du corps du modele de transformation --> 
</xsl :template> 

Argument formel du modele nomme 
I <xsl :param name=" . . . "/> 

Argument formel du modele nomme (avec valeur par defaut) 

I <xsl:param name="..." select=" .. .expression XPath.../> 

Variante d'argument formel du modele nomme (avec valeur par defaut) 

<xsl rparam name=" . . . "> 

<!-- modele de transformation du parametre --> 

<!-- fin du modele de transformation du parametre --> 
</xsl :param> 

instruction xsi : tempi ate est une instruction de premier niveau ; il est done impossible 
de declarer un modele nomme a I'inteheur d'un autre modele nomme. 

Les arguments formels sontfacultatifs, mais s'ils sont presents, lis doiventetre places en 
premier, avant le debut du corps du modele de transformation. 

Modele nomme typique 

U n modele nomme aura souvent la forme suivante : 

<xsl :templ ate name="..."> 

<xsl rparam name="truc"/> 

<xsl rparam name="machin"/> 

<!-- corps du modele de transformation --> 

... reference a $truc ... reference a $machin ... 

<!-- fin du corps du modele de transformation --> 
</xsl rtempl ate> 

Semantique 

U n modele nomme est instancie exactement comme peut I'etre un modele de transforma- 
tion associe a une regie (c'est-a-dire un modele de transformation « ordinaire », comme 
tous ceux que nous avons vu jusqu'a present). 
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La seule chose qui differencie I'instanciation d'un modele de transformation « ordi- 
naire » de celle d'un modele de transformation nomme, c'est la nature de I'evenement 
declencheur : dans le premier cas, c'est la selection d'une regie choisie par le moteur 
XSLT (apres recherche de concordance de motif) ; dans le deuxieme, c'est un appel 
explicite, du style : instancier le modele « tartampion » en lui fournissant les arguments 
« true » et « machin ». 

Mais une fois I'evenement declencheur passe, et I'instanciation en cours, plus rien ne 
distingue les deux types de model es de transformation. Done tout ce qui a ete vu dans a 
la section I nstanciation d 'un modele de transformation relativement a un n^ud courant 
et une liste courante, page 90, reste valable pour I'instanciation d'un modele de transfor- 
mation nomme. 



Exemple 

N ous supposerons ici que nous voulons realiser un site Web d'annonces de concerts, pre- 
sentees en frangaisou en anglais. Une solution estdedupliquer lesite, afin d'en avoir une 
version frangaise et une version anglaise. M ais c'est evidemment la mauvaise solution 
(maintenance en double, et risque d'incoherence entre les deux versions). Une meilleure 
solution consiste a maintenir un seul site, et a mettre en place un systeme de traduction 
automatique. Ici, la traduction automatiqueestenvisageable, car lesitenecontientaucun 
texte redactionnel : uniquement des noms propres (de personnes ou de villes), des dates 
et des noms d'instruments. 

L'idee est done de maintenir uniquement un fichier XML contenant les informations a 
publier, et de mettre au point un programme XSLT qui va generer le code HTM L tout en 
assurant la traduction. 

Afin de ne pas surcharger I 'exemple, nous nous contenterons de montrer comment rea- 
liser la traduction, en laissant de cote la generation de code HTM L, qui n'a rien de parti- 
culierement original ni interessant. 

Enfin, la traduction reposant sur un dictionnaire, 11 serait logique de penser que ce dic- 
tionnaire constitue un fichier XML separe, maintenu independamment du fichier XML 
des annonces. Cela implique I'utilisation delafonction predefinie standard documento 
poury acceder ; nousferons done d'abord lechoix, un peu artificiel, il estvrai, de placer 
ce dictionnaire dans une variable globale codee en dur dans le programme XSLT. A ce 
titre, cet exemple constituera un complement interessant a eel ui etudie a la section Utili- 
sation d'unTST obtenu litte'ralement (XSLT 1.1 ou plus), page 199. Ensuitenous verrons 
comment utiliser cettefonction standard do cument( ) , 

Void le fichier XML des annonces : 
annonces .xinl 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<Annonces> 
<Annonce> 
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<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date> 

<Jour id="jeu"/> 

<Quantieine>17</Quantieme> 

<Mois id="jnv"/> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Llrsules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument id="bvr7> 
</Interprete> 

<Interprete> 

<Noin> Sylvia Abramowicz </Noin> 

<Instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Noin> Freddy Eichelberger </Noin> 

<Instrument id="clv"/> 
</Interprete> 

<Concert> 

<TitreConcert lang="fr"> 

Folies d'Espagne, Bourrasque et Tourbillon 
Gavotte La Ferme - Chaconne de Rougeville 

</TitreConcert> 

<TitreConcert lang="en"> 

Spanish folias. Squall and Whirlwind 
Gavotte Shut Up - Redtown's Sillycate 

</TitreConcert> 
</Concert> 

<Compositeurs> 

<Compositeur>Marin Marais</Composi teur> 
<Compositeur>Jean de Sainte Colonibe</Compositeur> 

</Compositeurs> 

</Annonce> 

<!-- autres annonces ... --> 
</Annonces> 
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Etvoici le programme XSLT : 

annonces.xsl 

<?xnil version="1.0" encoding="UTF-16"?> 

<xsl :styl esheet xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl :param name="langueCible">fr</xsl :parani> 

<xsl :variable name="Dictionnaire"> 

<niot id="bvl "> 

<traduction 1 ang="f r">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 
</mot> 

<mot id="vdg"> 

<traduction lang="fr">Viole de gambe</traduction> 
<traduction lang="en">Viola da gamba</traduction> 
</mot> 

<niot id="lth"> 

<traduction 1 ang="f r">Luth</traduction> 
<traduction 1 ang="en">Lute</traduction> 
</mot> 

<mot id="clv"> 

<traduction 1 ang="f r">Cl avecin</traduction> 
<traduction 1 ang="en">Harpsichord</traduction> 
</mot> 

<mot id="flt"> 

<traduction 1 ang="f r">Fl ute a bec</traduction> 
<traduction 1 ang="en">Recorder</traduction> 
</mot> 

<mot id="thb"> 

<traduction 1 ang="f r">Theorbe</traduction> 
<traduction 1 ang="en">Theorbo</traduction> 
</mot> 

<niot id="lun"> 

<traduction 1 ang="f r">l undi</traduction> 
<traduction 1 ang="en">monday</traduction> 
</mot> 



<!-- etc. (les autres jours de la semaine) --> 
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<mot id="dini"> 
<traduction 
<traduction 

</mot> 

<mot id="jnv"> 
<traduction 
<traduction 

</mot> 



ang="f r">dimanche</traduction> 
ang="en">sunday</traduction> 



ang="f r">janvier</traduction> 
ang="en">january</traduction> 



<!- 



etc. (les autres mois de I'annee) --> 



<mot id="dcb"> 

<traduction 1 ang="fr">decembre</traduction> 

<traduction 1 ang="en">december</traduction> 
</mot> 

</xsl :variable> 

<xsl itemplate name="traduction"> 
<xsl:parain name="motId"/> 

<xsl :variable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$inot Id]" /> 

<xsl ivariable 

name="saTraduction" 

select="$motTrouve/traduction[@lang=$langueCible]" /> 

<xsl :val ue-of select="$saTraduction" /> 
</xsl itempl ate> 

<xsl : tempi ate match="Date"> 

<xsl :call-template name="tradLiction"> 

<xsl :with-param name="motId" select=" ./Mois/@id" /> 

</xsl :call-template> 
</xsl itempl ate> 

<xsl itemplate match="Interprete"> 

-<xsl :val ue-of select="./Noin"/> : 

<xsl :call-template name="traduction"> 

<xsl iwith-param name="motId" select="./Instrument/@id" /> 
</xsl :call-template> 
</xsl itempl ate> 

<xsl itemplate match="text( )" /> 



</xsl :stylesheet> 
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La structure de ce programme XSLT est tres simple : un parametre global donnant la 
langue cible pour la traduction, une variable globale contenant la description X M L du 
dictionnaire, un modelenomme prenanten donneeun identifiantdemot, etinstanciantsa 
traduction dans la langue cible, et final ement deux regies, une pour I es dates, et une pour 
les instrument! stes, utilisantchacune le service de traduction offert par le modelenomme. 

Le modele nomme re^oit en donnee un identifiant de mot, Son instanciation commence 
par la constitution d'un node-set (variable motirouve) contenant tous les elements <mot> 
du dictionnaire qui sont tels que leur attribut id soit egal a I'identifiant de mot re^u en 
donnee; normalement, si le dictionnaire est bien fait, le node-set obtenu ne doit pas 
contenir plus d'un element ; et si le mot que I 'on cherche a traduire existe effectivement 
dans le dictionnaire, le node-set contient au moins un element. 

Le node-set contient done final ement un et un seul element, un <mot>. 

L'instanciation du modele nomme se poursuit avec la constitution d'un node-set (va- 
riable sairaducti on) contenant tous les elements <traduction> enfants directs du noeud 
unique selectionne a I'etape precedente, tels que I 'attribut lang de chacun d'entre eux 
soit egal a la langue cible ; la encore, si le dictionnaire est bien construit, 11 n'y a qu'un 
seul el ement repondantau critere. Le node-set obtenu contient done un etun seul element 

<traducti on>. 

L'instanciation du modele nomme se termine avec l'instanciation de I'instruction 
xsi :vaiue-of, qui en I 'occurrence, est remplacee par la valeur textuelle du node-set ne 
contenant que cet unique element <traduction>, c'est-a-dire la valeur textuelle de cet 
unique element lui-meme. 

Note 

En general, ce n'estpas tres pertinent de faire calculeria valeur d'un node-set quelconque parxsl:value-of, car 
seul le premier noeud estpris en compte :les autres sont carrement ignores. Mais ici, il n'y a pas de question a se 
poser, puisque le node-set possede par construction un et un seul element : il n'y a done pas de perte en ligne. 

Reste a expliquer I'appel du modele nomme dans les deux regies qui I'utilisent. Mais 
pour §a, il nous faudra regarder de plus pres I'instruction xsi : can -tempi ate, ce que 
nous ferons a la section suivante. En attendant, void comment utiliser la fonction 
documentc ) pour extemaliser le dictionnaire dans un fichier XM L secondaire. 

Le dictionnaire sera place dans un fichier "dictionnaire.xmi " ; I'instruction a changer 
est bien sur I'initialisation dela variableDictionnaire : 

I <xsl ivariable naine="Dictionnaire" select="document( 'dictionnaire.xmi ' )/Dictionnaire"/> 

L a foncti on document ( ) peut etre appelee sous di verses formes, et nous aurons I 'occasi on 
de voir d'autres exemples d'appel ; celui montre ci-dessus est un des plus simples pos- 
sible : I'argument est une chaine de caracteres representant I'URL du fichier a lire. Le 
fichier doit etre au format X M L ; il est lu, converti en arbre XM L, et la fonction renvoie 
un node-set contenant uniquement la racine del 'arbre. Notez bien qu'il s'agitdela racine 
de I'arbre, et non de la racine du document. Done si I'on veut que la variable di cti onnai re 
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contienne comme dans la version precedente un node-set constitue de tous les <mot>, il 
faut initialiser avec I'expression : 

^ document( 'dictionnaire.xml ' )/Dictionnaire 

et non pas seulement : 

f clocument( 'dictionnaire.xml ' ) 

Une amelioration possible serait que le nom du fichier fourni comme argument de la 
fonction document ( ) ne soit qu'une valeur par defaut, la vraie valeur etant fournie comme 
parametre dans la ligne de commande. On about! rait alors a la version finale suivante : 

annonces.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xnilns:xsl=" http://www.w3.org/1999/XSL/Transform'' 
version=''1.0"> 

<xsl:Dutput method^'text' encoding='IS0-8859-r /> 

<xsl iparam name^'l angueCibl e''>f r</xsl :param> 

<xsl iparam name="dicDFileRef''>dictionnaire.xml</xsl :param> 

<xsl ivariable name="Dictionnai re" 

sel ect= " document ( $di coFi 1 eRef) /Diet ionna ire" /> 

<xsl itemplate name="traduction"> 
<xsl iparam name^'motld"/) 

<xsl ivariable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$mot Id]" /> 

<xsl ivariable 

name="saTraduction" 

sel ect="$motTrouve/traduction[@l ang=$l angueCibl e]" /> 

<xsl ivalue-of select="$saTraduction" /> 
</xsl itemplate> 

<xsl itempl ate match=''Date"> 

<xsl icall-template name="traduction"> 

<xsl iwith-param name="motId" select="./Mois/@id'' /> 
</xsl icall -template> 
</xsl itempl ate> 

<xsl itempl ate match=" Interprete"> 

-<xsl ivalue-of select="./Nom''/> i 

<xsl icall-template name=''traduction''> 

<xsl iwith-param name="motId'' select="./Instrument/@id"/> 
</xsl icall-template> 
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</xsl itempl ate> 

<xsl : tempi ate match="text( )" /> 
</xsl :stylesheet> 

Le fichier dictionnaire reprend les donnees qui se trouvaient auparavant dans la variable 

Di cti onnai re : 
dictionnaire.xml 



<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<Dictionnaire> 

<mot id="bvl"> 

<traduction 1 ang="f r">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 

</mot> 

<mot id="vdg"> 

<traduction lang="fr">Viole de gambe</traduction> 
<traduction lang="en">Viola da gamba</traduction> 

</mot> 



<!-- etc. 



(comme avant) 



-> 



<mot id="dcb"> 

<traduction 1 ang="f r">decembre</traduction> 
<traduction 1 ang="en">december</traduction> 
</mot> 
</Dictionnaire> 

Apres ce petit detour par la fonction documento, nous revenons maintenant au propos 
initial, I'appel d'un modele nomme. 



Instruction xshcall-template 

L'instruction xsi :caii -template permet de lancer I'instanciation d'un modele nomme. 



Bande-annonce 



Voir la bande-annonce de instruction <xsi :tempiate name=". . ."> (voir Bande-annonce, 
page 220). 



Syntaxe 



xsl : call -tempi ate 

<xsl :call-template naine="..."> 
I <!-- arguments effectifs pour I'appel 
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<!-- fin des arguments effectifs pour I'appel --> 
</xsl :can-template>/> 

Argument effectif 

<xsl :with-param name="..." select="... expression XPath ..." /> 

Variante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de 1 'argument effectif --> 

<!-- fin du modele de transformation de 1 'argument effectif --> 
</xsl :with-param> 

L'instruction xsi :caii -template ne doit pas apparaitre en tantqu'instruction de premier 
niveau. 



Semantique 

LorS de son instanciation, l'instruction <xsl :call-template>. . .</xsl :call-template> 

est remplacee par sa valeur, qui n'est autre que celle resultant de I 'instanciation du 
modele nomme (voir figure 5-6, qui montre sur I'exemple precedent quelle peut etre la 
valeur d'instanciation d'un appel de modele nomme). 



Programme XSLT 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl:stylesheet 

xmlns:xsl="http://www. w3.org/1999/XSL/Transform" 
xmlns:saxon=" http://icl.com/saxon" 
version="1.0"> 

<xsl:output method='text' encoding='ISO-8859-r/> 
<xsl : param name=" I angueC i bl e" >f r</xsl : param > 



Annonces 
An nonce 




Norn 

Sylvia 



I nstrument 

id="bvr' 



<xsl :template match=" I nterprete" > 

- <xsl:value-of select="./Nom"/> : 

<xsl:call-templatename="traduction"> 
<xsl:with-param 
name="motld" — 
selects" ./instrument/® id" /> 

</xsi:caii-tempiate> 

<yxsi:tempiate> 

Instanciation 



Abramowicz 



Basse devioie 



Figure 5-6 

Valeur d'instanciation possible pour un appel de modele nomme. 
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L'instanciation du modele nomme se passe en deux temps : 

(1) les arguments effectifs sont evalues, et donnent leur valeur aux arguments formels. 
S'il y a un argument effectif dont le nom ne correspond aaucun argument formel, il 
est tout simplement ignore, et ce n'est pas une erreur ; s'il y a un argument formel 
dont I e nom ne correspond aaucun argument effectif, sa valeur par defaut entre enjeu 
et lui donne sa valeur. 

(2) la valeur de tous les arguments formels etant connue, I e modele nomme est alors ins- 
tancie comme n'importe quel autre modele de transformation : tout se passe comme 
si les arguments formels etaient des variables declarees au debut du modele, avec une 
valeur precisement egale a celle qui vient d'etre calculee (voir figure 5-7). On est 
done ramene a l'instanciation d'un modele de transformation comportant des decla- 
rations de variables locales, que nous avons deja vue a la section Utilisation d'une 
variable, page 184. Lors de l'instanciation, le noeud courant et la liste courante res- 
tent identiques a cequ'ils etaient au moment du can -tempi ate, cequi permetd'eva- 
luer les expressions X Path contenues dans le modele nomme comme si elles avaient 
ete directement ecrites dans le modele contenant I 'appel cai i -tempi ate, 

Les appels recursifs ne sont pas interdits ; mais comme d'habitude en pareil cas, il faut 
s'assurer que I 'appel recursif ne va pas engendrer de recursion infinie. 

Note 

Au cas ou vous ne seriez pas a I'aise avec la recursion, reportez-vous au chapitre sur les patterns de program- 
mation, qui donne quelques rappels sur la recursion, montre comment I'utiliser, dans quels cas I'utiliser, etsitue 
son importance relativementaux autres notions ou techniques propres aXSLT, 

Example 

Tous les elements sont maintenant reunis pour que I'exemple vu a la section Exemple, 
page 223, soit completement analysable ; ils sont resumes a la figure 5-7. 

On lance le programme XSLT comme ceci : 
Ligne de comtnande 

I Java com. icl .saxon. Stylesheet -o annonces.txt annonces .xml annonces.xsl 

Etvoici leresultatobtenu : 

Resultat 

Janvier 

- Jonathan Dunford : 
Basse de vide 



- Sylvia Abramowicz : 
Basse de viole 
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M odele 



<xsl:value-of select-' ./Nom7> 



<xsl:call-template name-'traduction" 
<xsl:with-param 
name-'motid" 

select-' ./lnstrument/@id" /> 
</xsl:call-template> 



I nstanciation du 
template 
(2) 



Evaluation de 
I 'argument 
motid 
(1) 



\ 



Fragment de 
document resultat 



recopie 

evalue 
recopie 

1+2+3+4+5+6 



Sylvia Abramowicz 



Basse devlole 



Instruction fictlve : voir texte decrlvant 
les deux etapes de I'instanciatlon d'un 
xshcall-template 



<zsl:variable naine="motId" select="'bvr"/> 



<xsl:variable 
name-'motTrouve" 
select="saxon:node-set($Dlctlonnalre)/ 
motl@ld=$motld]" /> 

<xsl:varl able 
name-'saTraduction" 
select="saxon:node-set($motTrouve)/ 
traductlon[@lang=$langueClble]" /> 

<xsl:value-of select="$saTraductlon" /> 



(3) 
(4) 

(5) 
(6) 



Basse devlole 



Figure 5-7 

Les e'tapes de I 'instanciation d 'un appel de modele nomme. 
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- Benjamin Perrot 
Theorbe 



- Freddy Eichelberger 
Clavecin 



On lance le programme XSLT commecela : 

Ligne de comtnande (une seule ligne d'un seul tenant) 

I Java com. icl .saxon. Stylesheet -o annonces.txt annonces.xml annonces.xsl 
langueCible^en 

Et voila le resultat : 

Resultat 

January 



- Jonathan Dunford : 

Bass viol 

- Sylvia Abramowicz : 

Bass viol 

- Benjamin Perrot : 

Theorbo 

- Freddy Eichelberger 

Harpsi chord 



Instruction xshapply-templates 

L'instruction xsi :appiy-tempiates a deja ete vue (voir section Instruction xshapply- 
templates, page 131) ; nous la revoyons icl a cause du fait qu'une regie et un modele 
nomme peuvent donner un hybride (voir Instruction xshtemplate, page219). Une regie 
pouvant declarer des parametres, 11 est done logique que la regie selectionne puisse en 
recevoir 



xsi :app1y-tetiip1ates 

<xsl rapply-templates select="..." mode="..."> 
<!-- arguments effectifs pour I'appel --> 

<!-- fin des arguments effectifs pour I'appel --> 
</xsl :apply-templates>/> 



Syntaxe 



Argument effectif 

I <xsl :with-param name="..." select="... expression XPath ..." /> 
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Van' ante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de 1 'argument effectif --> 

<!-- fin du modele de transformation de 1 'argument effectif --> 
</xsl :with-param> 

instruction xsi :appiy-tempiates ne doit pas apparaitre en tant qu'instruction de pre- 
mier niveau. Les attributsmode et select sont facultatifs. 

Semantique 

La seulecliose nouvelleest la presence des arguments effectifs (xsi :with-param) dans I e 
model ede transformation dexsi :appiy-tempiates. S'il y a des parametres, lis sonteva- 
lues et transmis aux regies selectionnees. Ce n'est pas une erreur si I'une d' el les ne prend 
pas d'argument en donnee, et ce n'est pas non plus une erreur si I'une d'elles prend en 
donnee un parametre qui n'est pas transmis. 

J 'avoue m'etre creuse la tete pour trouver un exemple interessant de transmission de para- 
metre a une regie XSLT par I'intermediaire d'une instruction <xsi :appiy-tempiates>. 
Sans resultat sur le moment ; mais en faisant tout autre chose, je suis tombe sur un cas oil 
c'est vraiment utile. Rendez-vous done a la section Pattern n° 18 - Localisation d'une 
application, page 533 pour un exemple illustrant cette notion. 

Instruction xshmessage 

L'instruction xsi :message affiche un message et eventuellement, arrete I'execution du 
processeurXSLT. 

Syntaxe 

xsi :tiiessage 

<xsl :message> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :message>/> 

xsi :tiiessage (variante syntaxique) 

<xsl :message terminate="yes"> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :message>/> 

L'attrlbut facultatif terminate=". . ." peut recevoir deux valeurs possibles : yes ou no. 
La valeur no est la valeur par defaut. 
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L'instruction xsi:message ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Semantique 

L'instanciation de l'instruction <xsi :message> se traduit par I'instanciation de son 
model e de transformation, qui est ensuite sorti quel que part de telle sorte que I 'util isateur 
puisse le voir Cela peut etre par exemple une boite d'alerte, la sortie standard d'erreur, 
ou autre (le standard X SLT ne specifie pas la nature exacte de la sortie). 

En general, le model e de transformation contient uniquement du texte, mais le standard 
ne I'impose pas. Rien n'interdit que des elements XML soient instancies, mais que 
pourra bien faire une boite d'alerte de texte balise en X M L ? 

L es messages sont general ement des messages d'erreur, mais ce n'est pas une obligation. 
Lorsque I'attribut terminate est present avec la valeur yes, I'execution du processeur 
X SLT s'arrete apres la sortie du message, et le document resultat en cours de constitution 
est mis a la poubelle. 

Lefait que la sortie utilisee pour un message ne soit pas bien definie en reduit un peu la 
portee. Avec Saxon, par exemple, le message est affiche sur la sortie standard d'erreur ; 
on peut done I'utiliser en complement de <xsi :comment> pour faire du depistage 
d'erreurs : <xsi :message> pour attirer I'attention sur le fait qu'une condition anormale 
est survenue, et <xsi :comment> pour afficher la trace sans perturber la sortie quand tout 
va bien. M ais si les messages sortent dans des boites d'alerte, cela peut devenir tres vite 
exasperant de devoir les refermer sans arret. 



Instruction xshkey 

L'instruction xsi :key etablit une declaration d'association entre des noeuds d'un arbre 
XML source et des valeurs. 

Bande-annonce 

Dictionnaire.xml 

<?xml version="1.0" encocling="UTF-16" standalone="yes"?> 
<Dictionnaire> 
<mot id="clini"> 

<tracluction 1 ang="f r">dimanche</traduction> 
<traduction 1 ang="en">sunday</traduction> 
</mot> 

<mot id="lun"> 

<traduction 1 ang="f r">l undi</traduction> 

<traduction 1 ang="en">nionday</traduction> 
</mot> 
</Dictionnaire> 
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Declaration de cle 

<xsl:key name="traduction" match="mot" Lise="attribute: rid" /> 

Apres avoir declare la cle, on peut utiliser la structure obtenuegracea la fonction keyo, 
a qui I'on transmet le nom de la cle , ainsi que la valeur de cle, Elle renvoie un node-set 
qui contientleou les noeudsqui ontete attaches a cette valeur par une declaration decle 
comme celle montree ci-dessus (voir figure 5-8, page 236). 




unM ot 



<xsl:variable name-'unM ot" select ="key('traduction', 'lun') "/> 

Figure 5-8 

Utilisation d'une cle. 

Syntaxe 

xsl : key 

I <xsl:key name="..." inatch=" .. .motif ... " use=" .. .expression ... "/> 

L'lnstructlon xsi :key est une instruction de premier niveau, etde premier niveau unique- 
ment. 



Instruction xshkey H 
ChapitrFT^B 

Ni le motif, ni ('expression, ne peuvent contenir des references a des variables ou des 
appels a la fonction predefinie keyo. Les instructions xsi :key sont evaluees avant les 
variables globales. Ces restrictions ont pour but d'empecher d'eventuelles circularites. 

Semantique 

instruction xsi : key declare une cle. 

Une cle possede un nom et associe des valeurs a des noeuds. Le nom est fourni par 
I'attribut name, et les noeuds concernes sont ceux (d'un certain arbre XML source) qui 
concordent avec le motif de I'attribut match ; quand un noeud concorde avec le motif, sa 
valeur-cle est celle qui resulte de devaluation de I'expression donnee par I'attribut use, 
en prenant ce noeud comme noeud contexte. 



Remarque 

Notez ce point extremement important : I'arbre XML source dans lequelserontcherches les ncBuds concordants 
n'est pas determine. L'instruction xsl :key ne fait rien, en elle-meme. Son effet sur le processeur XSLT est 
simplement de lui demander de noter au passage les trois attributs name, match, et use, mais pas d'effectuer 
une recherche ni de construire une table d'associations. 

L'instruction xsi :key ne s'utilise jamais seule, car son instanciation ne produit rien. De 
memequ'une declaration de variable x n'a de sens que si une reference $x a cette variable 
existequelque part, de meme une instruction xsi :key n'a de sens que par rapport a I 'uti- 
lisation de la fonction predefinie key( ). 

Dans le cas le plus simple, lors d'un appel a la fonction keyCN. v), on transmet en argu- 
ment le nom N de la cle (qui doit se retrouver en tant qu'attribut name d'une instruction 
xsl :key), etunevaleurV de type string. Untel appel intervientnecessairement dans une 
expression, ou un noeud contexte est defini, puisqu'un noeud contexte esttoujours defini 
pour I'evaluation d'une expression. Ce noeud contexte fait partie d'un arbre XML 
source; cetarbreXML source est eel ui qui sera explore pour determiner les associations 
noeuds/valeurs. L'effet est le suivant : 

• la table des associations pour cette cle N etce document source est construite, amoins 
que cela ne soit deja fait (a cause d'un precedent appel) ; 

• le node-set des noeuds associes a la valeur V est extrait de cette table, et renvoye 
comme resultat. 

Le temps perdu a construire la table peutetre largement regagne ensuite car lesacces aux 
node-sets par leur valeur-cle sont quasiment instantanes, en tout cas independants du 
nombre de noeuds de I 'arbre XML source. 

Ceci etant, il y a maintenant deux aspects essentiels et complementaires a voir, c'est la 
maniere dont cette fameuse table est construite, et celle dont elle est exploitee. 
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Remarque 

Pour etre honnete, il faut signaler ici que tout ce qui vient d'etre explique est assez eloigne de la presentation 
faite parte standard XSLT, qui ne parle absolumentpas de tabte, nide sa construction, ni de temps gagne, ni de 
temps perdu ;qui ne ditpas que I'instruction xsl :key nefaitapeu pres rten, ni ne ditque c'estl'appel ala fonc- 
tion key( ) qui declenche tous les traitements. En fait, le standard se place a un niveau plus abstrait, contraire- 
ment aux explications donnees ici, qui font reference a des techniques d'implementation, notamment par table 
associative. Neanmoins, il esttres difficite de se figurerle fonctionnementdu couple instruction xsl :key /fonc- 
tion keyC ) sans avoir un modete de traitement present a I'esprit pour guider la pensee. Le modele de traitement 
presente ici, a base de table associative, n'est pas impose par le standard, mais il va tellementde sol qu'il est 
difficite d'imaginerun processeurXSLT s'en ecartantfondamentalement 

De toute fafon, cette presentation des choses centree surl'emploi d'une tabte associative n'est pas fonctionnel- 
lement fausse : au pire, on peut dire qu'une implementation pourrait legitimement reposer sur des techniques 
totalement differentes, a condition que I'effet obtenu soit te meme, abstraction faite des questions de perfor- 
mance etde rapidite d'acces. 



Construction et exploitation de la table associative 

U ne cle possede un nom et associe des valeurs a des noeuds : on a done affaire a une rela- 
tion ternaire entre cles, valeurs et noeuds, dont le but est d'indexer des noeuds par des 
valeurs. Le modele presente figure 5-9 resume cela graphiquement. 




Figure 5-9 

L 'association cle, 
valeur, nom. 




Le modele de la figure 5-9 se lit comme ceci : 

• il y a une action «Associe» (c'est une association) 
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• unecle est Tagentdecette action (c'estellequi faitl'action) ; 

• une val eur est I 'objetdecette action (c' est a el I e que I 'action s'applique) ; 

• un noeud est un autre objet de cette action (c'est aussi a lui que Paction s'applique). 
Lesnombres« 1 » et« l+» (1 ou plus) indiquessontlescardinalites ; ellesselisentainsi : 

• une cle peut etre I 'agent de une ou plusieurs associations ; 

• une association a pour agent une seule cle ; 

• une valeur peut etre I'objet de une ou plusieurs associations ; 

• une association peut avoir pour objet une ou plusieurs val eurs ; 

• un noeud indexe peut etre I'objet de une ou plusieurs associations ; 

• une association peut avoir pour objet une ou plusieurs noeuds indexes. 

Dans la pratique, toutes ces combinaisons peuvent se produire, nous verronscela sur des 
exemples. 

Lorsd'un appel a lafonction key( ), le noeud contexte del 'expression englobante est fixe. 
Cenoeud contexte designeimplicitementl'arbreXM L aexplorer pour construire la table. 
D'autre part, le premier argument de I'appel est le nom de la cle : il faut done trouver 
I'instruction xsi :key dont I'attribut name a pour valeur ce nom. L'ayant trouvee, on a 
alors un motif (attri but match) et une expression (attribut use). Si on n'en trouveaucune, 
c'est une erreur, maissi on en trouve plusieurs, on n'en rejetteaucune ; nousverronsplus 
bascequ'on en fait. Pour I 'instant, nouscontinuonsen supposantquel'on a trouve exac- 
tement une instruction xsi : key. 

La construction de la table d'association implique une exploration complete de la total ite 
des noeuds de I'arbre source : pour chacun d'eux, on teste sa concordance avec le motif, 
S'il n'y a pas concordance, le noeud est ignore ; s'il y a concordance, I'expression est 
evaluee en utilisant ce noeud comme noeud contexte. L'evaluation de cette expression 
peut donner un node-set ou non : 

• Si le resultat n'est pas un node-set, il estconverti en string, et cette valeur est la valeur 
de la cle. Le noeud concordant est done range dans la table, associe a cette valeur de 
cle. 

• Si le resultat est un node-set, la valeur textuelledechaque noeud estcalculee; cesdif- 
ferentes valeurstextuelles sontautant de valeurs-cle pour le noeud concordant, qui est 
done range dans la table, associe a chacune de ces valeurs. 

Si on trouve plusieurs instructions xsi :key de meme valeur d'attribut name, la table est 
construite en utilisant le motif et I'expression de la premiere instruction trouvee, puis 
chaque instruction xsi:key supplemental re donne un nouveau motif et une nouvelle 
expression, qui donne lieu a une nouvelle exploration de I'arbre source : la table est sim- 
plement mise a jour en y ajoutant les nouvelles associations qui decoulent de chaque nou- 
velle exploration. 
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Note 



En deuxieme lecture, il pourra etre interessantdefaire le rapprochement entre les figures qui arriventmaintenant 
(figures 5-10, 5-11, 5-12 et5-13) etia figure 8-1 de la section Pattern n'9 -Identitede nceuds et node-set de 
valeurs toutes differentes, page 434. 

Une association d'une valeura un noeud 

C 'est la situation la plussimple ; elleest resumeedansia figure 5-10, qui montrela struc- 
ture logique de la table d'association, construite a partir du fichier Dictionnaire.xmi 
(voirci-dessous) etde la declaration : 

Declaration de cle 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 



• root 



Nceud 
Indexe 



,,<Dictionnaire> 




Valeur 




traduction 



<traduction> 



dimanche 




<Mot>rdm 



<traduction> 



Sunday 



Figure 5-10 

U ne association d 'une valeur a un nojud. 
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Dictionnaire.xml 



<?xnil version="1.0" 
<Dictionnaire> 



encocling="UTF-16"?> 



<mot id="dim"> 
<traduction 
<traduction 



1 ang="f r">dimanche</traduction> 
1 ang="en">sunday</traduction> 



</mot> 
</Dictionnaire> 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-r /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 

<xsl :template name="afficher"> 
<xsl:parain naine="code"/> 

<xsl ivariable name="mot" select="key( 'traduction' , $code)"/> 

<xsl :for-each select=''$mot/traduction''> 

<xsl :val ue-of select=''$code"/><xsl :text> ( </xsl:text> 
<xsl :val ue-of select=''@lang"/><xsl :text> ) : </xsl:text> 
<xsl :val ue-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl : for-each> 
</xsl :template> 

<xsl : tempi ate match="/''> 

<xsl icall-template naine="afficher"> 

<xsl :with-param name="code" select="'dim"'/> 

</xsl : cal 1 -tempi ate> 
</xsl :templ ate> 

<xsl itemplate match="text( )"/> 
</xsl :stylesheet> 
Resultat 

. dim ( fr ) : dimanche 
I dim ( en ) : Sunday 

Lorsde I'appel a la fonction key( ), lenoeud contexteest la racinedel'arbreXM L source 
(car instruction call -template ne change pas lenceud contextecourant) ; done c'estcet 
arbre qui est explore pour construire la table. 

Voyons maintenant comment evolue la table si I 'on rajoute une entree dans le diction- 
naire. 
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Deux associations, avec une valeur et un noeud par association 

Nousreprenonsexactementia meme declaration decle, maisavec un dictionnaireadeux 
entrees : 

Dictionnaire.xtnl 

<?xml version="1.0" encocling="UTF-16" standal one="yes"?> 
<Dictionnai re> 
<inot id="dim"> 

<traduction 1 ang="f r">diinanche</traduction> 
<traduction 1 ang="en">sunday</traduction> 
</mot> 

<mot id="lun"> 

<traduction 1 ang="f r">l undi</traduction> 

<traduction 1 ang="en">monday</traduction> 
</niot> 
</Dictionnaire> 

La figure 5-11 resume graphiquement ce que cela donne. 




.root 



dim 




Valeur 



<Mot>rfun 



<traduction> 



monday 



Figure 5-11 

Deux associations, avec une vaieur et un naud par association. 
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traduction.xsl 

... idem ... 

<xsl : tempi ate match="/"> 

<xsl :cal 1 -tempi ate name="afficher"> 

<xsl :with-param name="code" sel ect=" 'dim' "/> 
</xsl :call-template> 
<xsl :call-template name="afficher"> 

<xsl :with-param name^'code" sel ect=" ' 1 un ' "/> 
</xsl :call-template> 
</xsl :templ ate> 
... idem ... 

Resultat 

dim ( fr ) : dimanche 

dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 

Deux associations, avec deux valeurs et un noeud par association 

Nous gardens ici lememedictionnaire, mais nous changeons la declaration decle : 

Declaration de cle 

I <xsl:key name=''traduction'' match^'mot" use="traduction" /> 

Chaque <mot> du dictionnaire Concorde avec le motif ; pour cliacun d'eux, ('expression 
evaluee est done : 

I ./child: :traduction 

I OLi " . " est le <mot> courant. 

Cette expression selectionne pour cliaque <mot> un node-set dedeux elements, puisqu'il 
y a deux traductions par mot. Done ici, chaque mot va etre associe a deux valeurs, qui 
sont I es valeurs textuel I es des elements <t raducti on>. L a figure 5-12 resume cela graphi- 
quement. 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-r /> 

<xsl:key name="traduction" match="mot" use="traduction" /> 

<xsl :template name="afficher"> 
<xsl:param name="unMot''/> 

<xsl ivariable name="motTrouve" select="key( 'traduction' , $unMot)"/> 
<xsl ivariable name="sonCode" select="$motTrouve/@id"/> 



<xsl :for-each select="$motTrouve/traduction"> 
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<xsl :value-of select="$sonCode"/><xsl :text> ( </xsl:text> 
<xsl :value-of select="@lang"/><xsl :text> ) : </xsl:text> 
<xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :teirpl ate> 

<xsl itempl ate match="/"> 

<xsl : call -tempi ate name="aff i cher"> 

<xsl :with-param name="unMot" select=" 'dimanche"7> 
</xsl :call-template> 
<xsl :call-template name="aff i cher"> 

<xsl iwith-param name="unMot" select=" 'monday "7> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 




Figure 5-12 

Deux associations, avec deux vaieurs et un nceud par association. 
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Resultat 

dim ( fr ) : dimanche 
dim ( en ) : Sunday 
lun ( fr ) : lundi 
lun ( en ) : monday 

Remarquer ici que la determination du mot se fait non plus par son code, mais par sa 
valeur frangaise ou anglaise. 

Deux associations, avec une valeur et deux noeuds par association 

N ous gardons ici le meme dictionnaire, mais nous changeons a nouveau la declaration de 
cle: 

Declaration de cle 

I <xsl:key name="traduction" match="traduction" use="@lang" /> 

Pour chaque element <traduction>, I 'expression "@iang" ne donne qu'une seule valeur, 
M ais 11 setrouveque pi usieurs elements ont la meme valeur d'attribut lang ; on va alors 
construire une table dont la structure logique est resumee par la figure 5-13. 




Figure 5-13 

Deux associations, avec une valeur et deux niruds par association. 
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traduction.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl:key name="traduction" match="traduction" use="@lang" /> 

<xsl :template name="afficher"> 
<xsl:param name="l angue"/> 

<xsl ivariable name="traductionsTrouvees" select="key( 'traduction' , $langue)''/> 

<xsl :text> 
</xsl :text> 

<xsl :text>Langue = </xsl itextXxsl :val ue-of sel ect^'Sl angue"/><xsl :text> : 
</xsl :text> 

<xsl :for-each select="$traductionsTrouvees"> 
<xsl :value-of select='' . "/> 
<xsl:text> ( code : </xsl:text> 
<xsl :value-of select=''. ./@id"/> 
<xsl:text> ) </xsl:text> 
<xsl :text> 
</xsl :text> 

</xsl :for-each> 
</xsl :template> 

<xsl :teinpl ate match=''/"> 

<xsl icall-template name^'aff i cher"> 

<xsl :with-param name="l angue" sel ect=" ' f r ' "/> 
</xsl :call -teniplate> 
<xsl icall-template name="aff i cher"> 

<xsl iwith-param name=''l angue" select="'en'"/> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl itempl ate match^'textC ) "/> 
</xsl :stylesheet> 

Resultat 

Langue = fr : 

dimanche ( code : dim ) 
lundi ( code : lun ) 

Langue = en : 

Sunday ( code : dim ) 
monday ( code : lun ) 
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Construction d'une table a partird'un document XML auxiliaire 

Nous avons deja ditque I'arbreXM L explore lors de la construction de la table est celui 
qui contient le noeud contexte, lors de I'evaluation de I'expression XPath donnant une 
valeur-cle a I'association. Si cen'est pas I'arbresourceXM L principal, cela peutetre un 
TST lie a une variable, ou un arbre fourni par la fonction documentc ), qui construit un 
arbresecondaired'apresun fichier externeXM L. Danstouslescas, 11 faut pouvoirchan- 
gerde noeud contexte demaniere a changer d'arbre explore. Oril n'y a qu'uneseule ins- 
truction capable de changer temporal rem ent le noeud contexte, c'est instruction 
xsi :for-each. Donc si I'on veut que la table d'association soit construite a partir d'un 
arbre XML qui n'est pas I'arbre principal, I'appel a la fonction keyo devra necessaire- 
ment faire partie du modele de transformation d'une instruction xsi : f or-each adequate. 

L'exemple vu a la section Deux associations, avec une valeur et un no-ud par associa- 
tion, page 242 pourrait etre repris comme ceci, en supposant que le document principal 

n'aitrien a VOiraveC Dictionnaire.xml : 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output inethod='text' encoding=' ISO-8859-r /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 

<xsl itemplate name="afficher"> 
<xsl:parain naine="code"/> 

<xsl :f or-each sel ect=" document ( 'Dictionnai re.xml ' )"> 

<xsl :variable name="mot" select="key( 'traduction' , $code)"/> 

<xsl :for-each select=''$mot/traduction''> 

<xsl :value-of select=''$code"/><xsl :text> ( </xsl:text> 
<xsl :value-of select=''@lang"/><xsl :text> ) : </xsl:text> 
<xsl :val ue-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :for-each> 
</xsl :template> 

<xsl :template match="/''> 

<xsl :cal 1 -tempi ate name="afficher''> 

<xsl :with-param name="code" select="'dim"'/> 
</xsl :call-template> 
<xsl icall-template name="afficher"> 

<xsl :with-param name="code" sel ect=" ' 1 un ' "/> 
</xsl :call-template> 
</xsl :templ ate> 



Les instructions de programmation 

Chapitre 5 

|<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

dim ( fr ) : dimanche 

dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 

Variante 

II y a une variante possible pour I'appel de la fonction keyc ). Elle consiste a transmettre 
comme deuxieme argument un node-set NS au lieu d'une String. Mais ce n'est rien 
d'autre qu'unefacilite syntaxique : cela revient a appeler n fois la fonction keyc ) avec la 
valeurtextuelledechacun des noeudsdu node-set NS en deuxieme argument, eta prendre 
comme resultat global, I'union ensembliste de chacun des n node-sets renvoyes separe- 
ment. 



Exemples 

Les exemples classiques, en matiere de manipulation de cles, concernent les references 
croisees (Pattern n° 13 - Generation d 'hyper liens, page 468, Pattern n° 12 - Refe'rences 
croisees inter ^chiers, page459), les regroupements (Pattern n°14 - Regroupements, 
page 474), les constitutions de node-sets d'elements tous differents suivant un certain 
critere (Node-set de valeurs toutes diffe'rentes, page 438). 

M ais rien n'interdit d'utiliser une cle dans des domaines pas du tout classiques : seule 
I'imagi nation, en dernier ressort, peut nous I i miter, 
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L es instructions de creation sont celles qui produisent du texte dans I e document resultat, 
sans qu'il s'agisse de texte provenant de la transformation d'elements du source XML 
traite par le programme X SLT. 

Nous commencerons par instruction <xsi:text>, qui permet de regler I'emission 
d'espaces blancs dans le document resultat, et accessoirement, de controler I'habillage 
ou le deshabillage de caracteres speciaux normal ement proteges dans leur carapace 
XML. 

Ensuite, nous reviendrons sur I' utilisation d'un element source litteral a contenu calcule 
pour creer du texte X M L dans le document resultat. Nousavionsdeja vu cela (voir Utili- 
sation d'un TST calcule (XSLT 1.1 ou plus), page 203), mais ici nous en verrons une 
forme plus evoluee, permettant de parametrer les valeurs de certains attributs, grace a la 
notion dedescripteur de valeur diffe're'e d'attribut (Attribute Value Tempi ate). 

Puis nous verrons les instructions XSLT permettant deprodui re du texte XM L (elements 

et attributs) ; Ce sont les instructions <xsl :element>, <xsl :attribute>, et <xsl :attri- 

bute-set>. Ces instructions peuvent paraitreun peu inutiles, etant donne les possibilites 
offertes par les elements source litteraux, telles qu'on les aura vues. Neanmoins, nous 
verrons qu'il y a des cas ou elles sont indispensables, notamment lorsque les noms des 
ballses XM L qui doiventfigurer dans le document resultat ne sont pas connusau moment 
Ou on ecrit le programme. 

Dans le meme ordre d'idee, viendront enfin les instructions permettant de sortir des 
commentaires XML ou des processing-instructions XML ; ce sont les instructions 

<xs1 :connment>, et <xsl :processing-instruction>. 
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Instruction xshtext 

Bande-annonce 

L'instruction <xsi :text> est souvent utilisee pour placer des espaces blancs significatifs 
dans le programme source XSLT. Dans I'exemple ci-dessous, c'est un saut de ligne qui 
est place : 

Nom.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl istylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itemplate naine="insererSautLigneApresTexte"> 

<xsl:param name="texte"/> 

<xsl :val ue-of select="$texte" /> 

<xsl :text> 
</xsl :text> 

</xsl :templ ate> 

<xsl itempl ate match="Nom"> 

<xsl :cal 1 - tempi ate name="insererSautLigneApresTexte"> 
<xsl :with-param name="texte" select="."/> 

</xsl : call -tempi ate> 
</xsl itempl ate> 

<xsl itempl ate match="text( ) "/> 
</xsl istylesheet> 
Concert.xtnl 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Llrsules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 
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</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Noni> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Composi teur>M. Marais</Composi teur> 

<Composi teur>D. Castel 1 o</Compositeur> 

<Composi teur>F. Rognoni</Composi teur> 
</Compositeurs> 

</Concert> 

Resultat 

Jonathan Dunford 
Sylvia Abramowicz 
Benjamin Perrot 

Syntaxe 

xsl :text 

<xsl :text> 

<!-- modele de transformation --> 

... texte brut (pas de texte XML et encore moins XSL) ... 
<!-- fin du modele de transformation --> 
</xsl :text> 

L'instruction xsi :text ne doit pas apparattre en tant qu'instruction de premier niveau. 
Semantique 

L'instruction xsi :text ne peut contenir que du texte non balise (done aucune instruction 
XSLT ne peut apparaitre comme enfant d'un element <xsi:text>, ni meme du texte 
XML d'un domaine nominal different de "xsi :"), 

L'instanciation decette instruction consisted recopier le texte de son modele de transfor- 
mation dans le document resultat. II n'y a pas vraiment besoin d'instruction xsi :text 
pour faire 9a, puisque c'est le fonctionnement normal de toute instanciation de tout 
modele de transformation : le texte brut qui s'y trouve est recopie dans le document 
resultat. 

M ais ^instruction xsi :text trouve sa raison d'etre lorsqu'ellenecontient que desespaces 
blancs (dans ce cas on est sur que ces espaces blancs seront pris en compte, et recopies 
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dans le document resultat), ou lorsqu'elle contient du texte sans espace blanc (dans ce 
cas, on est sflr qu'il n'y aura pas d'espace blanc parasite ajoute au document resultat) : 
s'occuper des espaces blancs, tel est le role (officieux) devolu a cette instruction. 

Exemple 

Nous reprenons ici I'exemple vu a I'occasion de instruction xsi rchoose (voir Instruc- 
tion xsl:choose, page 174), dans lequel 11 y a un probleme de repartition des espaces 
blancs dans le document a produire (I 'exemple se trouve a la section Exemple, page 176). 

Lefichier resultat que I 'on avait obtenu etait lesuivant : 
Resultat 

flute a bee 

Michel Keustermans et Laura Pok 
viole d'amour 

Vinciane Baudhuin 

oboe da caccia 

Blai Justo 

viole de gambe 

Rika Murata . Martin Bauer . Sophie Watillon 
violone 

Benoit vanden Bemden 

orgue positif et clavecin 

Jacques Wlllemijns 

On admettra facilement que ce n'est pas totalement satisfaisant, et qu'il serait mieux 
d'avoirquelque chose commececi : 

Resultat 

I flute a bee : Michel Keustermans et Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

M als avant de voir comment I'instruction xsi :text va pouvoir intervenir pour resoudre 
le probleme, I! faut comprendre ce qui se passe exactement. 

D'une manieregenerale, des qu'il y a des problemes d'espaces blancs dans un document 
resultat, les questions a se poser sont les suivantes : 

• Y a-t-il des espaces blancs en trop ? Si oui, proviennent-ils du fichier source X M L ou 
du programme XSLT ? 
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• M anque-t-il des espaces blancs ? Si oui, il faut intervenir sur le programme XSLT (et 
non pas sur lefichier sourceX M L), et dans ce cas, il n'y a rien demieux que instruc- 
tion xsl :text. 

S'il y a des espaces blancs en trop, quefaire? Leseliminer, bien sur, 

M ais la faeon d'eliminer des espaces blancs en trop n'est pas la meme suivant qu'ils pro- 
viennentdu fichier source XM L oudu programmeXSLT lui meme: 

• Ceux qui proviennent du fichier source XM L seront broyes par la fonction standard 

normalize-spaceO OU par I'instrUCtion <xsl : stri p-space>. 

• Quant a ceux qui proviennent du programmeXSLT, ^instruction xsi:text pourra a 
nouveau faire quelque miracle. 

Note 

L'instruction <xsl :strip-space> a ete vue a I'occasion de I'instruction <xsl :if> (voir la section Exemple, 
page 170). 

Reste a savoir comment faire pour determiner I'origine d'un espace blanc, que rien ne 
distingue a priori d'un autre. 

Le principe est simple : il faut mettre des marqueurs dans le programme XSLT, et voir 
comment se situent les espaces blancs en trop par rapport aux marqueurs. 

Prenons par exemple les espaces blancs indesi rabies qui se trouvent entre « flute a bee » 
et le caractere « i », et ceux qui se trouvent entre « : » et « M ichel », dans le document 
resultat montre ci-dessus, et essayons de determiner leur origine par des marqueurs. 

L e programme est eel ui -ci (sans changement par rapport a ce qu'on avait a la section I ns- 
truction xshclioose, page 174) : 

ProgramtneConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl : tempi ate match="Rol e"> 

<xsl :val ue-of sel ect=" . /chi Id: : text( )"/> : 
<xsl :choose> 

<xsl iwhen test="count( . /Interprete) = 1 "> 

<xsl :value-of sel ect=" Interprete"/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
sel ect=" Interprete[2]"/> 
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</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/><xsl :if test="not(position( ) = 
last())">. </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Le caractere « : » present juste apres I'instruction xsi :vaiue-of constitue deja en lui 
meme un marqueur. Les espaces blancs qui setrouvent entre « flute a bee » et « : » pro- 
viennent done neeessairementdu fiehier soureeXM L, On va les supprimer avee un appel 

a normal ize-space( ) : 

^ <xsl :val ue-of select="nornial ize-space( . /child: :text( )) "/> : 

Cette fonetion elimine tous les espaees blanes situes en debut et en fin de la ehaine de 
earaeteres donnee, et remplaee toute sequenee interne d'espaees blanes par un seul . Dans 
notre eas, la donnee a traiter se presente eomme eeei (oil les « \n » et « \t » designent res- 
peetivement le earaetere de fin de ligne et de tabulation) : 

<Role>\n 
\t \t \t \t viole de gambeXn 
\t \t \t \t <Interprete> 

lei, lafonetion normalize-spaceO va remplaeer la ehaine "\n\t\t\t\tviole de gambeX 
n\t\t\t\t" par "viole de gambe". 

La regie devienteelle-ei : 

<xsl itempl ate match="Role"> 

<xsl :value-of select="nornial ize-space( ./child: :text( )) "/> : 
<xsl :choose> 

<xsl :when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
select= "Interprete [2] "/> 

</xsl :when> 
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<xsl :otherwise> 

<xsl :for-each sel ect=" Interprete"> 

<xsl :val ue-of select="."/><xsl :if test="not(posiotion( ) = 
last())">, </xsl :if> 

</xsl : for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl itempl ate> 

Etvoici cequeceladonne: 

R esultat 

flute a bee : 

Michel Keustermans et Laura Pok viole d'amour : 
Vinciane Baudhuin oboe da caccia : 
Blai Justo viole de gambe : 

Rika Murata, Martin Bauer, Sophie Watillon violone : 
Benoit vanden Bemden orgue posltif et clavecin : 
Jacques Willemljns 

Tous les espaces blancs situes avant chaque nom d'instrument ont ete supprimes (ce qui 
entraine la perte des sauts de ligne). Reste a voir les espaces blancs qui sont situes apres 
les caracteres 

Pla^ons le marqueur « ! » avant le nom de chaque premier artiste de chaque ligne : 

<xsl : tempi ate match="Rol e"> 

<xsl :val ue-of sel ect="norinal ize-space( . /chl Id: : text( ) )"/> : 
<xsl :choose> 

<xsl :when test="count( . /Interprete) = 1 "> 

!<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl iwhen test="count( . /Interprete) = 2 "> 

!<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
sel ect="Interprete[2]"/> 

</xsl :when> 

<xsl :otherw1se> 

!<xsl :for-each select="Interprete"> 

<xsl :val ue-of select="."/><xsl :if test="not(posit1on( ) = 
last())">, </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 



</xsl :templ ate> 
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Resultat 

flDte a bee : 

! Michel Keustermans et Laura Pok viole d'amour : 
! Vinciane Baudhuin oboe da caccia : 
! Blai Justo viole de gambe : 

! Rika Murata, Martin Bauer, Sophie Watillon violone : 
! Benoit vanden Bemden orgue positif et clavecin : 
! Jacques Willemijns 

Clairement, lesespaces blancsen trop sontdans le programme XSLT. C'estvrai toutefois 
que I'espace entre le « ! » et la premiere lettre de chaque ligne provient necessai rement 
du fichier X M L , M ais le gros de la troupe provient du fichier X SLT, 

Par ailleurs, on constate qu'il manque un saut de ligne avant chaque nom d'instrument, 
depuis que nous avons mis en service la fonction normal ize-spaceo, etqu'un nouveau 
saut de ligne est apparu avant chaque « ! » depuis que nous avons place ce marqueur 

La contre-experience pourrait consister a enlever le marqueur « ! » (qui ne sert plus a 
rien maintenant qu'il aditcequ'il avaitadire), eta en mettreun (parexempleune«* ») 
devant chaque nom d'instrument: 

<xsl itempl ate match="Role"> 

*<xsl :value-of select="normalize-space( ./child: :text( ))"/> : 
<xsl :choose> 

<xsl:when test="count( . /Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl:when test="count( . /Interprete) = 2 "> 

<xsl :value-of select="Interprete[l]"/> et <xsl :val ue-of 
select= "Interprete [2] "/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl :value-of select="."/><xsl :if test="not(position( ) = 
last())">. </xsl :if> 

</xsl :for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :template> 
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Resultat 

*flQte a bee : 
Michel Keustermans et Laura Pok 

*viole d' amour : 
Vinciane Baudhuin 

*oboe da caccia : 
Blai Justo 

*viole de gambe : 

Rika Murata , Martin Bauer , Sophie Watlllon 

*violone : 
Benoit vanden Bemden 

*orgue positif et clavecin : 
Jacques Willemljns 

On constate done que la presence du marqueur n'est pas neutre, etqu'elle induit ['appa- 
rition desautsdelignes. 

Pourquoi ? La feuille de style XSL est un document XM L, ne I'oublions pas. A ce titre, 
elle est constituee, elleaussi, de noeuds de type text etd'elementsXML, En particulier 
le debut de la premiere regie sepresenteainsi : 

<xsl : tempi ate match="Rol e">\n 

\n 

\t \t \t *<xsl :val ue-of sel ect="normal ize-space( . /child: :textC ) )"/> :\n 
\t \t \t <xsl :choose> 

Les« \n » et« \t » designenta nouveau lecaracteredefin de I igneetde tabulation. Done, 

entre le noeUd <xsl :template match="Rol e"> et le noeUd <xsl :value-of select="nor- 

maiize-space( ./child: :text( ))"/>, 11 y a un noeud text, dont la valeur est la chainede 
caracteres "\n\n\t\t\t*", OrleprocesseurXSLT traiteles noeuds text presents dans I es 
model es de remplacement de la maniere suivante : 

• si le noeud text ne contient que des espaces blancs, 11 est elimine (et n'est done pas 
recopie dans le document resultat) ; 

• mais s'il contient au moins un caractere d'une nature differente (qu'il soit place au 
debut, au milieu ou a la fin), alors 11 est integralement preserve, et recopie tel quel dans 
I e document resultat. 

La presence ou non dece marqueur « * » change completement I 'allure du resultat final. 

Si on lemaintient, la chainede caracteres "\n\n\t\t\t*" est integralement recopiee dans 
le document resultat; si on le supprime, le noeud text correspondant est elimine, et 
I'aeration dueaux espaces blancs disparait. 
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L a solution n'est done pas difficile a obtenir : puisqu'on veut un saut de ligne avant chaque 
nom d'instrument, il suffit de placer un saut de ligne dans une instruction xsi :text. En 
effet, et c'est le propre de cette instruction, meme si le noeud texte qui lui est rattache ne 
contientquedesespacesblancs, il n'est pas elimine. 

<xsl itempl ate match="Role"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of select="normal ize-space( ./child: :text( )) "/> : 
<xsl :choose> 

</xsl :choose> 

</xsl :templ ate> 

Et puisqu'on ne veut pas changer de ligne apres le caractere « : », il suffit de faire 
en sorte que (1°) le saut de ligne qui se trouve juste apres ne fasse pas parti e du meme 
noeud texte, (2°) qu'il soit seul (avec eventuellement d'autres espaces blancs) dans 
son noeud texte, et (3°) que tout ce beau monde ne soit pas protege par une instruction 

xsl : text, 

II y a deux solutions : dans la premiere, on inclut le caractere « : » dans une instruction 

xsl : text : 

<xsl itempl ate match="Role"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of select= 

"normal ize-space( . /chi Id: :text( ) )"/> <xsl:text> : </xsl:text> 
<xsl :choose> 

</xsl :choose> 

</xsl :template> 

Dans la deuxieme, on exclut le saut de ligne du noeud texte contenant le caractere 

« »:« » xsl :text ? 
Note 

L'instruction xsl : variable, definissant une variable inutile etinitialisee avec une String vide seraitaussi pos- 
sible, dans le sens ou cela donnerait le meme resultat, mais il est evident que ce genre d'astuce stupide n'est 
pas a recommander 

<xsl :templ ate match="Rol e"> 



<xsl :text> 
</xsl :text> 

<xsl :value-of select= 
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"normal ize-spaceC . /chil d: :text( ) )"/> : <xsl:text/> 
<xsl :choose> 

</xsl :choose> 



</xsl :templ ate> 

On arrive done final ement a cette solution (dans laquelle on ell mine les espaces blancs 
sur les noms d'interpretes provenant du fichier XML et on ajoute un « . » a la fin de 
chaque ligne, pour completer la ponctuation) : 

ProgramtneConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding=' ISO-8859-1 ' /> 



<xsl :template match="Rol e"> 



<xsl :text> 
</xsl :text> 

<xsl :value-of select="normalize-space( ./child: :text())"/> : <xsl:text/> 
<xsl :choose> 



<xsl :when test="count( . /Interprete) = 1 "> 

<xsl : val ue-of sel ect= "normal ize-spaceC Interprete) "/>. <xsl : text/> 
</xsl :when> 



<xsl :when test="count( . /Interprete) = 2 "> 

<xsl : val ue-of sel ect=" normal ize-spaceC Interprete[l] ) "/> 
<xsl:text> et </xsl:text> 

<xsl : val ue-of sel ect=" normal ize-spaceC Interprete[2] ) "/>.<xsl : text/> 
</xsl :when> 



<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl : val ue-of sel ect=" normal ize-spaceC . ) "/> 
<xsl:if test="not(position( ) = last())"> 

<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
<xsl :text>.</xsl :text> 
</xsl :otherwise> 



</xsl :choose> 



</xsl :templ ate> 



<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 
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Ce qui donne (enfin) le resultat attendu : 
Resultat 

flute a bee : Michel Keustermans et Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

Variante syntaxique 

On peut si I'on veut ajouter un attribut disabie-output-escaping, avec la valeur "yes" 
ou "no" ("no" est la valeur par defaut), comme ceci : 



Employee avec I'attribut disabie-output-escaping, I'instruction xsi :text ne sert plus 
(ou plus seulement) a regler des problemes d'espaces blancs, mais a influencer la fagon 
dont certains caracteres (comme "<") devront apparaitre dans le document resultat, lors 
de la Serialisation de I'arbre resultat. Par principe, ces caracteres sont pudiquement mas- 
ques d'une feuille de vigne XM L (a ne pas confondre avec une feuille de style XSL), et 
apparaissent done sous forme de references de caracteres (comme "&#60:") ou de refe- 
rences d'entites (comme "&it:"), Si I'attribut disabie-output-escaping a pour valeur 
« yes », et que le mode de sortie est « html » ou « xml », lis apparaitront alors dans leur 
plus simple apparel I (en mode « text », les caracteres sortent toujours « nature » : le pro- 
blemenese pose pas). 




xsl :text 



<xsl :text disable-output-escaping=". . ."> 

... texte brut (pas de texte XML et encore moins XSL) ... 
</xsl :text> 



Semantique 



Exemple 



Dans la version precedente, nous remplagons la ligne : 



<xsl:text> et </xsl:text> 



par : 



^ <xsl:text disable-output-escaping="no"> & </xsl:text> 

On obtientceci : 



Resultat 



flute a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
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oboe da caccia : Blai Ousto. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watlllon. 

viol one : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

Comme on est ici en mode « text », les caracteres speciaux sortent tels quels, bien qu'on 
n'ait pas invalide la protection. Pour voir reellement ce que §a donne, 11 faut passer par 
exemple en mode «xml » (ce qui n'a aucun sens dans cet exemple, puisqu'il n'y a 
aucune baliseX M L dans I e document resul tat) : 

ProgramtneConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xinl ' 

encodings' ISO-8859-1' /> <!-- mode xml active Ici !!! --> 

<xsl itemplate match="Rol e"> 

<xsl :text> 
</xsl :text> 

<xsl :value-of sel ect="normal ize-spaceC ./chi 1 d: :text( ) ) "/> : <xsl:text/> 
<xsl :choose> 

<xsl:when test="count( . /Interprete) = 1 "> 

<xsl : val ue-of sel ect=" normal i ze-s pace ( Interprete) "/>.<xsl : text/> 
</xsl :when> 

<xsl :when test="count( . /Interprete) = 2 "> 

<xsl : val ue-of sel ect= "normal ize-space( Interprete[l] ) "/> 

<xsl:text d1sable-output-escap1ng="no"> & </xsl:text> 

<xsl : val ue-of sel ect= "normal ize-space( Interprete[2] ) "/>.<xsl : text/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl : val ue-of sel ect="normal ize-spaceC . ) "/> 
<xsl:if test="not(position( ) = last())"> 

<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
<xsl :text>.</xsl :text> 
</xsl :otherwise> 

</xsl :choose> 

</xsl itempl ate> 

<xsl itemplate match="text( )"/> 



</xsl :stylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
flOte a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Wi 1 1 emi jns . 

M aintenant, nous basculons la valeur de I'attribut disabie-output-escaping : 

<xsl:text disable-output-escaping="yes"> &ainp; </xsl:text> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
flDte a bee : Michel Keustermans & Laura Pok. 
viole d'amour : Vinciane Baudhuin. 
oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 
violone : Benoit vanden Bemden. 
' orgue positif et clavecin : Jacques Willemijns. 



Creation de texte XML par un element source litteral 

Nous allons ici reutiliser une technique deja vue (voir Utilisation d'un TST calcule 
(XSLT 1.1 ou plus), page 203), qui consiste a cabler dans un element source litteral a 
contenu calcule, la structureXM L que I'on veut obtenir : 

<xsl :templ ate match=''Concert''> 

<xsl rvariable name="mouvement"> 
<insert> 

<Ensembl e> 

<Nom><xsl :value-of sel ect="NomEnsembl e"/></Nom> 

<Di recti onXxsl : val ue-of select=''Chef "/X/Di recti on> 

</Ensemble> 

<Concert> 

<Date><xsl :value-of sel ect="Date"/></Date> 
<Ville><xsl :value-of select="Ville'7></Ville> 
<Lieu><xsl :value-of sel ect^'Sal 1 e'VX/Li eu> 
<Titre><xsl : val ue-of sel ect="Ti treConcert"/></Ti tre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of select^'Smouvement"/) 
</xsl itempl ate> 

Une fois instancie, I 'element source litteral <insert> donne un TST (Temporary Source 
Tree) dont la serialisation produitceci dans le document resultat: 
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instanciation de ce tnodele 

<insert> 

<Ensembl e> 

<Noni>. . .</Nom> 

<Di recti on>. . .</Di recti on> 
</Enseinbl e> 
<Concert> 

<Date>. . .</Date> 

<Ville>. . .</Ville> 

<LieLi>. . .</Lieu> 

<Titre>. . .></Titre> 
</Concert> 
</insert> 

On a done ici non pas une simple transformation d'un arbre source existant, mais bien 
une creation de fragment d'arbre entierement nouveau. 

Remarquez toutefois qu'on est dans un cas simple, ou seuls les contenus textuels des 
elements sont susceptibles de varier ; mais on peut se demander ce qui se passerait si 
certains elements devaienteux-memesdependrede la source XM L atraiter. 

II y a plusieurs degres de variabilite pour un element : 

• lenom d'un attributou d'un element dependede la source X M L, mais les valeurs pos- 
sibles sont a choisir parmi n valeurs connues au moment d'ecrire le programme ; 

• la valeur d'un attri but depend de la sourceXM L ; 

• le nom d'un attributou d'un element depende de la sourceXM L sans restriction. 

Seuls les deux premiers cas sont a la portee de la technique de I'element source litteral a 
contenu calcule; le troisieme necessite I'emploi des instructions <xsi :eiement> ou 
<xsi :atribut>, que I'on verra plus bas. 

Le premier cas ne met rien de nouveau en oeuvre ; il suffit de combiner I'emploi d'ele- 
ments source litteraux et d'instructions <xsi :choose>, 

Le deuxieme est plus coriace, comme nous allons maintenant nous en rendre compte. 

L'exemple choisi est assez classique, c'est la fusion de sourcesXM L, La fusion de deux 
documents XML, par exemple, consiste a en produire un troisieme, constituant d'une 
maniere ou d'une autre une synthese des deux autres. 

II s'agira ici de creer un document XM L, dont la structure sera fournie par un element 
source litteral a contenu calcule, exactement comme dans l'exemple ci-dessus; le 
contenu des elements sera preleve dans I'un des deux documents X M L, et la valeur des 
attri buts de ces elements sera prelevee dans I 'autre. 

Exemple 

Nous allons supposer que nous devons preparer un document de travail pour un recitant 
qui aura a declamer un texte pendant I 'execution d'une certaine piece pendant un concert. 
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Les documents de base sont d'une part le texte de la declamation (fichier deciamation- 
Taiiie.xmi) et d'autre part la liste des numeros de mesure ou doivent se situer les inter- 
ventions du recitant (fichier synopsisRecitant.xml) : 



Note 

Ce texte a ete ecrit par Marin Marais (probablement un douloureux souvenir personnel, I'operstion de la taille 
etant une extraction de calculs de la vessie, avec une priere en guise d'anesthesie) pour accompagner I'une de 
ses pieces de viole, publiee apres sa mort Sa veuve avait censure ce texte en le supprimantde la gravure offi- 
cielle (actuellement encore disponible en fac-simile), mais des copies ontcircule, et I'une d'entre elles nous est 
parvenue. La graphie en est curieuse, mais elle n'avait rien d'extraordinaire a une epoque ou I'orthographe 
(notion d'ailleurs totalement anachronique, on parlait plutot de grammaire) se reduisait en gros aux regies 
d'accord, eta des regies d'usage tres liberates, autorisantde nombreuses variations laissees au libre arbitre du 
scripteur. 

declamationTaille.xinl 

<?xml version="1.0" encoding="LITF-16"?> 
<texte> 

<reference> 

Pieces de viole du 5' livre, 1725 

Marin Marais 
</reference> 



<titre> 

Le Tableau de I'Operatlon de la Taille 
</t1tre> 

<paroles> 

<p>L'aspect de I'aparell .</p> 

<p>Fremissement en le voyant.</p> 

<p>Resolut1on pour y nionter.</p> 

<p>Parvenu jusqu'au hault;</p> 

<p>descente dudit apareil.</p> 

<p>Reflexions serieuses.</p> 

<p>Entrel assement des soyes 

Entre les bras et les jainbes.</p> 

<p>Icy se fait 1 'incision. </p> 

<p>Introduction de la tenette.</p> 

<p>Ici I'on tire la piere.</p> 

<p>Icy Ton perd quasi la voix.</p> 

<p>Ecoulement du sang.</p> 

<p>Icy I'on oste les soyes. </p> 

<p>Icy I'on vous transporte dans le 11t.</p> 
</parol es> 



</texte> 
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synopsisRecitant.xml 

<?xnil version="1.0" 
<synopsi sRecitant> 



encocling="UTF-16"?> 



<prol ogue/> 



<Nunieros> 

<NoMesure>l</NoMesure> 

<NoMesure>8</NoMesure> 

<NoMesure>ll</NoMesure> 

<NoMesure>15</NoMesure> 

<NoMesure>20</NoMesure> 

<NoMesure>22</NoMesure> 

<NoMesure>23</NoMesure> 

<NoMesure>27</NoMesure> 

<NoMesure>31</NoMesure> 

<NoMesure>39</NoMesure> 

<NoMesure>44</NoMesure> 

<NoMesure>48</NoMesure> 

<NoMesure>50</NoMesure> 

<NoMesure>53</NoMesure> 

</Numeros> 



</synopsisRecitant> 

On veut obtenir un documentXM L qui donne le textede la declamation, avec les nume- 
ros de mesure associes, comme ceci : 

synopsisRecitant.xml 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 
<mesure No="8">Freini ssement en le voyant.</mesure> 
<mesure No=''ll''>Resol ution pour y inonter.</mesure> 
<mesure No="15''>Parvenu jusqu'au hault:</inesure> 
<iiiesure No=''20''>descente dudit apareil .</mesure> 
<mesure No="22">Refl exions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No=''27''>Icy se fait 1 ' incision. </mesure> 
<mesure No=''31''>IntroductiDn de la tenette.</inesure> 
<mesure No=''39">Ici I'on tire la piere.</inesure> 
<mesure No="44">Icy I'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50">Icy I'on oste les soyes. </niesure> 
<mesure No=''53''>Icy I'on vous transporte dans le lit.</mesure> 
</recitant> 
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On va done comme prevu utiliser la technique de ('element source I itteral a contenu cal- 
cule. II estici particulierement simple, etant la structure extremement plate du document 
a produire : 

Element source 1 itteral a contenu calcule 

<mesure No=" . . . "> 

</niesure> 

II n'y a que deux valeurs calculees a placer dans I'element source I itteral : le numero de 
mesure, et le texte a declamer. 

L a feuille de style devant manipuler deux sources X M L , on va done proceder de la meme 
fagon quedans I'exemplevu a la section Exemple, page 223, ou il s'agissaitdefairedela 
traduction d'apres un dictionnaire : 

fusion.xsl 

i <?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method^'xml ' indent="yes" encoding='IS0-8859-r /> 
<xsl:param name="declamationFileRef" select=" 'decl amationTai 1 1 e.xml ' " /> 
<xsl ivariable naine="declamation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl itempl ate match="/"> 

<recitant> 

<xsl :apply-teniplates/> 

</recitant> 
</xsl itempl ate> 

<xsl itempl ate match="prologue"> 
<prologue> 

<xsl ivalue-of select="$declamation/titre"/> 
</prol ogue> 
</xsl itempl ate> 

<xsl itempl ate match="Numeros"> 
</xsl itempl ate> 

<xsl itempl ate match="text( ) "/> 
</xsl istylesheet> 

La source principale est le fichier synopsisRecitant.xmi, et la source secondaire le 
ficher dec! amationTai lie. xml . Cechoix est bien sflr arbitral re, mais comme la structure 
du document a produire est tres proche de la structure du document donnant le synopsis 
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du recitant, il est evidemment plus facile de partir du fichier synopsisRecitant.xmi que 

du ficher decl amati onTai 1 1 e .xml . 

Le texte de la declamation sera done accessible au travers de la variable deci amati on, qui 
en I 'occurrence est un node-set de trois elements, les trois elements rattaches a la racine 

<texte> du document XM L, a SaVOir : <reference>, <titre>, et <paroles>, 

Le noeud du probleme, ici, est devoir comment remplir I'element source litteral : 

|<mesure No=" . . . "> 
</mesure> 

Comme 11 y a plusieurs numeros de mesure a traiter, tous sur le meme modele, nous 
aurons done une instruction <xsi :for-each> : 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<inesure No=" ...(!)..."> 
...(2)... 

</niesure> 
</xsl :for-each> 
</xsl :templ ate> 

Le texte qui doit apparaitre en (2) est a determiner en fonction de la position du 
<NoMesLire> courant a I'interieur de instruction <xsi :for-each> : si par exemple 
I'element <NoMesure> en cours est le quatrieme fils de I'element <Numeros>, dans 
I'ordre de lecture du document, alors il faut aller chercher le quatrieme fils de I'element 
<paroies> dans ledocument contenant la declamation. Cela n'est pas du tout complique 
a faire: il suffit de sauvegarder dans une variable la position courante (c'est-a-dire la 
valeur4, dans notre exemple), etd'utilisercettevaleurdansun predicat: 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No=" ...(!)..."> 

<xsl :val ue-of select="$decl amati on/pa roles/p[positi on ( )=$i]"/> 
</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

On Select! onne tous les elements <p> enfantsde <paroies>, eton filtre en ne retenantque 
celui dont la position est precisementegale a $i, 

II n'y a plus qu'a renseigner la valeur de I'attribut (marquee « ...(1)... » ci-dessus). M ais 
avant de voir comment faire cela, il n'est pas ininteressant de tenter la petite experience 
suivante : on va placer en (1) une expression X Path quelconque, n'importelaquelle, juste 
pour voir ce que le processeur X SLT va en faire. 
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M essage d'erreur ? Evaluation ? Superbe indifference? Suspens... 

On choisit I'expression que I'on vient d'analyser; c'est bien sur completement idiot, 
mais voyons tout de meme : 

<xsl :templ ate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl ivariable naine="i" select="position( )" /> 
<mesure No="$cleclamation/paroles/p[position( ) = $i]"> 

<xsl :value-of select="$cleclaination/paroles/p[position() = $i]"/> 
</mesure> 
</xsl :for-each> 
</xsl itempl ate> 

On lance le processeur XSLT, et void cequ'on obtient : 

i nterventi onReci tant . xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de I'Operation de la Taille 
</prologue> 

<mesure No="$declamation/paroles/p[position() = $i ]">L'aspect de I'apareil. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">Freinissenient en le voyant. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">Resol ution pour y monter. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Parvenu jusqu'au hault; 
</mesure> 

<mesure No="$declaniation/paroles/p[position( ) = $i ]">descente dudit apareil. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">Reflexions serieuses. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Entrelassement des soyes 

Entre les bras et les jambes . </mesure> 
<mesure No="$declamation/paroles/p[position( ) = $i]">Icy se fait 1 'incision. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i ]">Introduction de la tenette. 
</mesure> 

<mesure No="$declaniation/paroles/p[position( ) = $i]">Ici I'on tire la piere. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Icy I'on perd quasi la voix. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Ecoulement du sang.</mesure> 
<mesure No="$declaniation/paroles/p[position( ) = $i]">Icy I'on oste les soyes. 
</mesure> 

<mesure No="$declamation/paroles/p[position( ) = $i]">Icy I'on vous transporte 
dans le 1 it.</mesure> 
</recitant> 
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Le resultat est assez eloquent. Pas de message d'erreur, pas d'evaluation : la valeur 
d'attribut est prise pour du texte ordinal re, restituetel quel dans le document resultat. 

Cela ruine completement I'espoir qu'on avait de produire les bons numeros de mesure, 
puisqu'apparemment, quelqu'expression que I'on puisse ecrire, elle sera prise pour du 
textea recopier, 

Completement ? Pas tout a fait ; le cas a ete prevu. 

La solution est d'utiliser ici ce qu'on appelle un descripteur de valeur diff«?r«?e d'attribut, 
ou Attribute Value Template (denomination du standard XSLT). Le mot template, ici, 
n'est pas le bienvenu ; il est deja surabondamment utilise en X SLT, et dans le cas present, 
son utilisation ne s'imposait vraiment pas, car un attribute value template n'a rien a voir 
avec une regie (template rule) ni un modele de transformation (template, suivant la 
denomination standard XSLT). 



Descripteur de valeur differee d'attribut (Attribute Vaiue Template) 

Un descripteur de valeur differee d'attribut, ce n'est pas une valeur d'attribut, mais c'est 
quelque chose qui decrit une valeur d'attribut. La valeur n'est done pas fournie directe- 
mentetlitteralement, elle est seulementdecriteet par consequent differee : il fauten effet 
attendre I'execution du processeur XSLT, qui va interpreter cette description, pour en 
tirer une valeur exploitable. 

Notez qu'il n'y a rien d'extraordinaire dans tout cela ; a chaquefois qu'on fournitl'attri- 
but select d'une instruction xsi :vaiue-of, comme par exemple : 

I select="$cleclamation/paroles/p[position() = $i]" 

on est dans la meme situation : la valeur de I'attribut n'est pas fournie litteral ement, mais 
sous forme d'un descripteur, qui est ici une expression X Path. Cette expression decritune 
valeur differee, puisqu'il faut attendre I'execution du processeur XSLT pour que deva- 
luation ait lieu. 

Mors dans ces conditions, pourquoi inventer une denomination speciale si la chose est 
deja connue, nommee, et courante ? 

Eh bien, pour la raison qu'on vient devoir. Si I'on emploie une expression X Path comme 
valeur d'attribut select, c'est parfait, puisquejustement, on est cense fournir une expres- 
sion XPath pour un attribut select, Par contre, ce n'est pas parfait du tout pour un attri- 
but inconnu intervenant inopinement dans un element inconnu du processeur XSLT, 
comme peuvent I'etre I'el ement <mesure> et I'attribut No. Le processeur n'ayant aucune 
connaissancesur les <mesure>, les No, ni toutes cessortes dechoses, il ne peut pas savoir 
si la valeur d'attribut qu'on fournit est une valeur litterale, ou une valeur a interpreter. 

II faut done le lui dire. Si on ne dit rien de special, la valeur fournie est litterale ; si on 
agite le chiffon rouge, le processeur est prevenu que la valeur fournie n'est pas litterale, 
mais que c'est une expression XPath aevaluer. 
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Le chiffon rouge en question, c'est une paire d'accolades : {abed} est un descripteur de 
valeur differee d'attribut, indiquant que la cliaine de caracteres « abed » est une expres- 
sion X Patli a interpreter comme telle. Commed'habitudeen pareil cas, 11 fauttrouver une 
astuce pour pouvoir eventuellement fournir une valeur litterale, qui malheureusement, 
seraitdela forme {abed} ; pour annuler l'effet« chiffon rouge » deces accolades, on les 
redouble, comme ceci : {{abed}}. 

Un descripteur de valeur differee d'attribut est done evalue en tantqu'expression XPath, 
et le resultat obtenu est converti en String, comme si la fonction standard stringo etait 
explicitementappelee. 

Remarque 

II ne suffit pas de demanderpouretre servi : les endroits ou le langage XSLT autorise I'emploi de descripteurde 
valeur differee d'attribut sont assez peu nombreux (et meme plutot rares) dans I'ensemble. lis sont repertories 
en annexe (voir Regies syntaxiques, page 525). 

Notez qu'un descripteur de valeur differee d'attribut ne constitue pas necessairement la 
totalite de la valeur d'attribut: on peut tres bien ecrire une expression du genre 
"xy{abed}zt" ; a I 'execution, la valeur d'attribut sera egale a la chaine litterale xy, suivie 
d'une String resultat de devaluation de I'expression XPath abed, suivie de la chaine litte- 
rale zt. 

Suite de I'exemple 

II ne nous reste plus qu'a utiliser cette notion de descripteur de valeur differee d'attribut 
pour terminer I'exemple que nous avions commence ci-dessus. 

N ous etions arrives a ce poi nt : 

<xsl itempl ate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl :variable naine="i" select="position( )" /> 
<inesure No=" ...(!)..."> 

<xsl : val ue-of select="$declaination/paroles/p[position() = $i]"/> 
</niesure> 
</xs1 :for-each> 
</xsl itempl ate> 

Le probleme est maintenant de renseigner la valeur de I'attribut No. Au point (1), I'ele- 
ment courant est un certain <NoMesure>. La valeur a placer dans I'attribut No est done la 
valeur textuelle de I 'element <NoMesure> courant. [.'expression XPath qui designe le 
noeud courant se reduisant simplementa« . », le descripteurde valeur differee d'attribut 
a utiliser sera done simplement "{.}". On arrive done a cette version du programme : 

fusion.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 
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xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 



<xsl:output method='xinl ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef" sel ect=" 'decl amationTai 1 le.xml ' " /> 
<xsl ivariable name="declamation" 

sel ect="docuinent( SdeclamationFileRef )/texte" /> 



<xsl itemplate match="/"> 

<recitant> 

<xsl :apply-teniplates/> 

</recitant> 
</xsl :teniplate> 



<xsl itemplate inatch="prol ogue"> 
<prologue> 

<xsl :value-of select="$declaination/titre"/> 
</prol ogue> 
</xsl :template> 



<xsl : tempi ate inatch="Nunieros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl :variable naine="i" select="position( )" /> 
<mesure No="( . ) "> 

<xsl :val ue-of select="$declamation/paroles/p[position() = $i]"/> 
</mesure> 
</xsl :for-each> 
</xsl :template> 



<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 

Et le resultat obtenu est bien celui qu'on attendait : 

interventionRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 
<mesure No="8">Fremi ssement en le voyant.</mesure> 
<mesure No="H">Resol ution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22''>Reflexions serieuses.</mesure> 
<mesure No="23''>Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27''>Icy se fait 1' incision. </mesure> 
<mesure No="31''>Introduction de la tenette.</mesure> 
<mesure No="39">Ici I'on tire la piere.</mesure> 
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<mesure No="44">Icy I'on perd quasi la voix.</mesure> 

<mesure No="48">Ecoul ement du sang.</inesure> 

<mesure No="50">Icy I'on oste les soyes.</mesure> 

<mesure No="53''>Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 

Conclusion 

Avec les notions d'element source litteral a contenu calcule et de descripteur de valeur 
differee d'attribut, on a deja une certaine souplesse pour creer des documents XML; 
mais, ainsi que nous I'avons vu plus haut, certaines possibilites restent hors d'atteinte. 
Pour aller plus loin, 11 faut pouvoir creer de nouveaux elements (ou de nouveaux attri- 
buts) dont le nom est obtenu comme le resultat de devaluation d' une expression XPath, 

C ' est ce que nous all ons vol r mai ntenant. 

Instruction xshelement 

Bande-annonce 

Cette instruction permet de creer des elements XML dans le document resultat. U n frag- 
ment de programme comme celui-ci : 

<Ensembl e> 
<Nom> 

<xsl :value-of select="NoinEnsemble"/> 
</Noni> 
<Di recti on> 

<xsl :value-of select="Chef "/> 
</Di rection> 
</Ensembl e> 

peut etre remplace par ceci : 

<xsl :element naine="Enseinbl e"> 
<xsl lelement name="Nom"> 

<xsl :value-of select=''NoinEnsemble"/> 
</xsl :el enient> 

<xsl lelement name="Di rection"> 

<xsl :value-of select="Chef "/> 
</xsl :el ement> 
</xsl :el ement> 

L'avantage est que I'attribut name accepte les descripteurs de valeurs differees d'attribut, 
cequi permet decalculer le nom de I'element, au lieu qu'il faille lecabler en dur dans le 
programme : 

<xsl lelement name=" {$x} "> 



</xsl :el einent> 
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Syntaxe 

xsl :e1 etnent 

<xsl:element name="..."> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :element> 

instruction xsi:eiement ne doit pas apparattre en tant qu'instruction de premier 
niveau. 

Semantique 

L'inStruCtion <xsl :element name="xxx"> ... </xsl : el ement> produit danS le docu- 
ment resultat un element XM L dela forme <xxx> . . . </xxx>, dont le nom estfourni par 
I'attribut name, et dont le contenu est le resultat del'instanciation du modele de transfor- 
mation associe. 

Exemple trivial 

Le premier exemple sera une simple mise en parallele de la creation d'un document 
XML par la technique de I'element source litteral a contenu calcule, et par cellede ins- 
truction xsl : element. 

Pour cela, nous reprenons I 'exemple vu a la section Utilisation d'un TST calcule (XSLT 
1.1 ou plus), page 203. Nous avions mis au point ce programme XSLT (la presentation 
est legerement modifiee pour faciliter la comparaison) : 

preparelnsert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl istylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

vers1on="1.0"> 

<xsl:output method^'xml' encod1ng=' ISO-8859-1 ' indent='yes' /> 

<xsl :template match="/"> 

<Mouvements> 

<xsl :apply-templates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl :template match="Concert"> 

<xsl ivariable name="mouvement"> 
<insert> 

<Ensembl e> 
<Nom> 

<xsl :value-of select="NomEnsemble"/> 
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</Nom> 

<Di recti on> 

<xsl :value-of select="Chef "/> 

</Direction> 
</Ensemble> 
<Concert> 

<Date> 

<xsl :value-of select="Date"/> 
</Date> 
<Ville> 

<xsl :value-of select="Ville"/> 
</Ville> 
<Lieu> 

<xsl :value-of select="Salle"/> 
</Lieu> 
<Titre> 

<xsl :value-of select="TitreConcert"/> 
</Titre> 
</Concert> 
</insert> 
</xsl :variable> 

<xsl :copy-of sel ect="$mouvement"/> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

On a ici la creation d'un document XML cable dans le programme X SLT sous la forme 
d'un element source litteral a contenu calcule. On va done voir comment faire la meme 

chose avec instruction xsl :element. 

La modification est assez triviale: dans la regie <xsi :tempiate match="Concert"> il 
suffit de remplacer chaque balise litterale (hors du domaine nominal d'XSLT) par une 
instruction xsi : element, comme ceci : 

<xsl : tempi ate inatch="Concert"> 

<xsl :variable naine="inouvenient"> 
<xsl :el ement name="insert"> 

<xsl :el ement name="Ensembl e"> 
<xsl:element name="Nom"> 

<xsl :value-of select="NoniEnsemble"/> 
</xsl :elenient> 

<xsl lelement name="Di rection"> 

<xsl :value-of sel ect="Chef "/> 
</xsl :elenient> 
</xsl :elenient> 

<xsl :el ement name="Concert"> 
<xsl:element name="Date"> 

<xsl :value-of select="Date"/> 
</xsl :element> 
<xsl:el ement name="Vi 1 1 e"> 
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<xsl :val ue-of select="Ville"/> 
</xsl :el einent> 
<xsl:element name="Lieu"> 

<xsl :val ue-of select="Salle"/> 
</xsl :el einent> 
<xsl:element name="Titre"> 

<xsl :value-of select="TitreConcert"/> 
</xsl :el einent> 
</xsl :element> 
</xsl :el einent> 
</xsl :variable> 

<xsl :copy-of sel ect="$niouvement"/> 
</xsl itempl ate> 

Cette regie est I'equivalent de celle montree dans le programme ci-dessus, et bien sur, a 
('execution, le resultat obtenu est strictement identique dans ledeux cas. 

M ais clairement, ici, instruction xsi :eiement n'apporte rien du tout, et rend meme le 
programme plus difficile a lire, en lui donnant une apparence plus confuse, 

Exemple plus evolue 

Nous allons ici revoir un exemple du meme genre que celui vu a la section Exemple, 
page 263 : un probleme de fusion de documents XML. M ais la difference avec le cas 
assez simple que nous avionsvu, est que cette fois, lenom des elements a produi re dans 
le document resultat est calcule lors du processus de fusion ; la technique de I'element 
source I itteral ne sera done pas utilisable. 

Le contexte est celui d'une application serveur, construite autour de technologies a 
objets, qui doit d'une part, presenter a un client leger (navigateur Web) emetteur de 
requetes, des donnees prelevees dans une base relationnelle et d'autre part, assurer la 
miseajouren temps reel de cette base, en fonction des requetes emises. L 'application est 
architecturee autour d'un referentiel metier, c'est-a-dire un ensemble de classes modeli- 
sant les entites et les relations issues d'une analyse semantique du metier sous-jacent, 
L'un des problemes classiques a resoudre est ce qu'on appelle le « mapping », dans le 
jargon consacre, c'est-a-dire la mise en correspondance d'une classeet d'une table, dans 
lecas le plus simple (les cas plus complexes sont ceux ou les attributs d'un objet corres- 
pondent a des colonnes reparties dans plusieurs table). Cette mise en correspondance 
consiste tout simplement a recuperer les bonnes colonnes dans la bonne table pour char- 
ger un objet, ou inversement, de mettre a jour les bonnes colonnes de la bonne table a 
partir des attributs d'un objet. 

II y a plusieursfagonsde realiser les mappings necessaires a I'application ; I'uned'entre 
elles, qui n'estpasia moinsmauvaise, consiste a ecri re un generateur decode capable de 
produi re automatiquement les classes (en Java, par exemple) qui vont realiser I 'interface 
entre les objets metier et la base de donnees. U n tel generateur de code va s'appuyer sur 
un fichier de mapping, qui pourrait avoir I'alluresuivante : 
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mapping .xtnl 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<inapping> 

<table>ACCORD</table> 

<ACCORD> 
<DEDEC> 

<f i el d>begi nni ng_date</f i el d> 

<type>BusinessDate</type> 
</DEDEC> 
<CCETF> 

<field>state</field> 

<type>Stri ng</type> 
</CCETF> 
<NOACA> 

<f i el d>company_i d</f i el d> 

<type>String</type> 
</NOACA> 
<N0POA> 

<f i el d>contract_nbr</f i el d> 

<type>String</type> 
</NOPOA> 
<CCPAA1> 

<f i el d>country_code</f i el d> 

<type>Integer</type> 
</CCPAAl> 
</ACCORD> 

<table>COMPANY</table> 
<COMPANY> 
<NOACA> 

<f i el d>company_i d</f i el d> 

<type>String</type> 
</NOACA> 
<LSACA1> 

<f i el d>company_name</f i el d> 

<type>String</type> 
</LSACAl> 
<CCPAA1> 

<f i el d>country_code</f i el d> 

<type>Integer</type> 
</CCPAAl> 
<LAACA1> 

<field>address</field> 

<type>String</type> 
</LAACAl> 
<URL> 

<field>URL</field> 

<type>Stri ng</type> 
</URL> 
<STATRAT> 

<field>qual ity_code</field> 
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<type>String</type> 
</STATRAT> 
</COMPANY> 
</mapping> 

DEDEC, ccETF, NOACA, etc. representent des noms de colonnes qui sont mis en correspon- 
danceavec des noms d'attributs (<fieid>) et des types Java (<type>). 

Ce genre de fichier, pour une petite application, pourrait etre constitue a la main ; mais 
pour une application qui doit se connecter a une base existante comportant une centaine 
de tables de dix a soixante colonnes dont les noms sont pour la plupart i mpronon^ables et 
difficiles a memoriser, 11 est clairqu'un travail a la main n'estpas adequat. 

L'administrateur de la base de donnees, mis a contribution, nous a fourni un fichier par 
table, ayant la structure suivante : 

accord.xml 

<?xnil version="1.0" encoding="UTF-16"?> 

<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6)<br/> 

N0P0A<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

</table> 

company .xml 

<?xnil version="1.0" encoding="UTF-16" ?> 

<table name="COMPANY"> 

N0ACA<tab/>CHAR(6)<br/> 

LSACAl<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

LAACAl<tab/>VARCHAR2(35)<br/> 

URL<tab/>VARCHAR2(40)<br/> 

STATRAT<tab/>VARCHAR2(l)<br/> 

</table> 

La Structure de ces fichiers n'est pas extraordinaire, mais lis contiennent les informations 
dont on a besoin (le nom des colonnes et le type SQL utilise) ; 11 faudra done faire avec. 
M ais bien sur, ce que ces fichiers ne donnent pas, c'est la correspondance des noms de 
colonnes et des noms d'attributs, Ce fichier de correspondance ne peut pas etre genere, 
11 faut le constituer a la main ; mais c'est moins penible que d'etablir a la main le fichier 
de mapping, car les memes noms de colonnes reviennent assez souvent dans des tables 
differentes. 

fields .xml 

<?xml version="1.0" encoding="UTF-16"?> 
<fields> 

<field id="DEDEC" >beginning_date</field> 
<field id="CCETF" >state </field> 
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<field id="NOACA" >company_id 



</field> 
</field> 
</field> 
</field> 
</field> 
</field> 
</field> 



<field id="NOPOA" >contract_nbr 

<field id="CCPAAl" >country_code 

<field id="LSACAl" >company_name 

<field id="LAACAl" >address 



<field id="URL" >URL 



<field id="STATRAT">quality_code 



</fields> 



Leprobleme est done maintenant pose : en partantdesfichiers accord .xml , company .xml 
et fields. xml, il s'agit de produire lefichier mapping.xmi. 

M ais, comme nous I'avons dit, il peut y avoir plusieurs dizaines de tables ; or il neserait 
pas raisonnable d'avoir plusieurs dizaines de sources XML pour le programme XSLT. 
Nous al Ions done commencer par reunirtoutesles sources de description de tables en une 
seule, en utilisantdesappelsd'entitesXM L externes, comme ceci : 

tables .xml 

<?xml version="1.0" encoding="LITF-16" ?> 
<!DOCTYPE tables [ 

<!ENTITY accord SYSTEM ' accord .xml' > 

I<!ENTITY company SYSTEM ' company. xml '> 
]> 
<tables> 
&accord; 
&company : 
^ </tables> 

Lefichier XML tables. xmi est equivalent a un fichier unique : 

<?xml version="1.0" encoding="UTF-16" ?> 
<tables> 

<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6)<br/> 

NOP0A<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

</table> 

<table name="COMPANY"> 

N0ACA<tab/>CHAR(6)<br/> 

LSACAl<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

LAACAl<tab/>VARCHAR2(35)<br/> 

URL<tab/>VARCHAR2(40)<br/> 

STATRAT<tab/>VARCHAR2(l)<br/> 

</table> 



</tables> 
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Nous aliens maintenant proceder en deux etapes. 
Premiere etape 

La premiere etape consiste a trouver comment recuperer les informations pertinentes 
dans lefichierXM L tables. xmi , dont la structure est bizarre, calquee sur une structure 
de fichier d'export de schema de base, mais pas du tout dans le style X M L . 

Le probleme est done de savoir comment, a partir du fichier tables. xmi, on pourrait 
obtenir le fichier suivant : 



table ACCORD : 










nom 


de 


col onne 




DEDEC: 


type = 


DATE 


nom 


de 


col onne 




CCETF; 


type = 


CHAR(l) 


nom 


de 


col onne 




NOACA; 


type = 


CHAR(6) 


nom 


de 


col onne 




NOPOA; 


type = 


VARCHAR2(35) 


nom 


de 


col onne 




CCPAAl; 


type 


= NUMBER(4) 


table 


:OMPANY 










nom 


de 


col onne 




NOACA: 


type = 


CHAR(6) 


nom 


de 


col onne 




LSACAl; 


type 


= VARCHAR2(35 


nom 


de 


col onne 




CCPAAl; 


type 


= NUMBER(4) 


nom 


de 


col onne 




LAACAl ; 


type 


= VARCHAR2(35 


nom 


de 


col onne 




URL; type = VARCHAR2(40) 


nom 


de 


colonne 




STATRAT; type 


= VARCHAR2(1 



Pour chaque table, il y a une succession d'elements <tab/> ; et pour chaque element 
<tab/>, lenom de colonne est le premier noeud detype text, si tue juste avant I 'element 
<tab/> courant (c'est le noeud en premiere position sur I'axe preceding-sibi ing), et le 
nom de type SQL est le premier noeud de type text, situe juste apres I'element <tab/> 
courant (c'est le noeud en premiere position sur I 'axe f oi i own ng-si bi i ng). 

Le programme XSLT qui produit le document resultat montre ci-dessus decoule directe- 
ment de cette remarque : 

essai .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmi ns : xsl = "http: //www. w3.org/1999/XSL/Transform" 

version="l .0"> 

<xsl:output method^'xml ' indent="yes" encodings' ISO-8859-1' /> 

<xsl : tempi ate match="tabl e"> 

<xsl :text/>tabl e <xsl :value-of sel ect="@name"/> :<xsl:text> 
</xsl :text> 

<xsl :for-each sel ect="tab"> 

<xsl :text>nom de colonne = </xsl:text> 
<xsl :value-of sel ect="normal ize-space( 

precedi ng-si bl ing: :text( ) [1] ) "/> 
<xsl:text>: type = </xsl:text> 
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<xsl :value-of select="normal ize-space( 

fol 1 owing-sibl ing: : text( )[!])"/> 

<xsl :text> 

</xsl :text> 

</xsl :for-each> 

</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Deuxieme etape 

II s'agit maintenant de faire la synthese entre la premiere source XML, representee par 
lefichier tables. xmi, et la deuxieme, qui donne la correspondance entre les noms deco- 
lonnes et les noms d'attributs. Ce probleme ressemble fortement au probleme de traduc- 
tion que nous avions vu a la section Example, page 223. Nous pourrons done reprendre 
les elements realisant une traduction, que nous avions mis au point a cette occasion, et 
les adapter a notre probleme actuel. 

II y a aussi unecertaineressemblanceavec ce que nous avonsvu a la section precedente 
(voir Example trivial, page 273), puisqu'il va etre question de creer des elements dans le 
document resultat. M ais la ressemblance n'est pas complete, car ici nous allons devoir 
creer des elements (comme <noaca> ) dont le nom ne peut pas etre mis « en dur » dans le 
programme. 

instruction qui fait cela est toujours I'instruction <xsi :eiement>, et a supposer que le 
nom del'element agenerer soitcontenu dans une variable eiementName, la premiere idee 
qui pourrait venir a I 'esprit serait d'ecrire quelque chose comme : 

<xsl :element name="$el ementNanie"> 

M ais on tombe sur le probleme deja analyse a la section Descripteur de valeur differ e'e 
d'attribut (Attribute Value Template), page 269 : a I 'execution, soit on va obtenir ceci : 

<$el einentName> 

|<field>. . .</fielcl> 
<type>. . .</type> 
</$elementName> 

alorsqu'on attend : 

<DEDEC> 

<field>. . .</field> 

<type>. . .</type> 
</DEDEC> 

soit on va obtenir un message d'erreur du processeurXSLT, degouted'avoirfailli mordre 
dans une ball seX M L pleine d'asticots (<$eiementName>), aenjuger parcelui qui setor- 
tilleau debut. 
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La solution est la meme que precedemment, il faut utiliser un descripteur de valeur diffe- 
reed'attribut. 



Attention 

Use trouve que nous sommes dans un cas, avec I'instruction <xsl :elemert>,ou un descripteur de valeur diffe- 
ree d'attributestautorise pour I'attribut name, Mais nous avons deja signals que ce n'etaitpas une construction 
toujours possible. 

Les descripteurs de valeurdifferee d'attributsont, il estvrai, toujours autorises etreconnus avec un elementXML 
faisantpartie d'un element source litteral, mais c'esttoutle contraire avec les attributs des elements XSLT (c'est- 
a-dire des instructions XSLT) : lis sonttres rarementacceptes ou reconnus. 

M ais I'instruction <xsi :eiement> fait partiedes heureuseselues, etga tombe bien, parce 
que sinon, il n'y avait plus qu'a mettre la cle sous la porte : ce qu'on voulait faire aurait 
ete impossible. 

Note 

Tiens, tiens ? Le langage XSLT n'auraitdonc plus eteTuring-completacause de ce detail stupide ? II y aurait eu 
des choses impossibles a programmer? Non, rassurez vous, cela n'aurait rien change au caractere Turing- 
complet du langage. En fait on peut se passer de descripteur de valeur differee d'attribut : il suffit de ne pas 
vouloir generer du texte XML, mais du texte ordinaire, quitte a sortir « a la main » tous les caracteres speciaux 
comme « <» ou « > »,Mais cela seraitde beaucoup plus bas niveau, beaucoup plus complique alire, etpropice 
auxerreurs.En effetunTST ne peut pas etre mal structure ;c'estnecessairementun arbre avec une vraie forme 
de vrai arbre, pas un eclope genetiquement modifie : si on bricole sol meme les boutures en contournant les 
regies lexicales de XML, on peutfaire beaucoup d'erreurs sans etre jamais averti parle parseurXML associe au 
processeurXSLT. 

Toujours est-il qu'en ecrivant : 

I <xsl:element name="{$elementNanie)"> 

au lieu de : 

I <xsl:element name="$elementName"> 

on a la solution. 

Rappelons que I'on veut obtenir quelque chose qui commence ainsi : 

<?xnil version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 

<ACCORD> 
<DEDEC> 

<field>beginning_date</field> 

<type>BLisinessDate</type> 
</DEDEC> 
<CCETF> 

<field>state</field> 
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<type>Stri ng</type> 
</CCETF> 
<NOACA> 

<field>company_id</field> 

<type>String</type> 
</NOACA> 

Un element comme <dedec> sera genere en allant chercher le texte situe juste avant le 
<tab/> courantdans lefichier tables. xmi (voir Premiere etape, page 279), en recuperant 
ce texte dans une variable eiementName, et en utilisant cette variable comme montre ci- 
dessus, dans une instruction xsi : element. 

Un element comme <fieid>beginning_date</fieid> sera genere en allant chercher la 
traduction du texte contenu dans seiementName, obtenue par un dictionnaire (le fichier 
fieids.xmi vu ci-dessus). Nous emploierons la meme technique que celle vue a la sec- 
tion Exemple, page 223, avec le dictionnaire lu en tant que source externe par la fonction 

documentC ). 

Enfin, un element comme <type>stn"ng</type> sera genere en allant chercher le texte 
situe juste apres I 'element <tab/> courant, et en testant s'il contient la chalne char ou 

VARCHAR. 

On aboutit done au canevas suivant : 

<xsl :for-each select="tab"> 

<!-- ici : elementName = le texte situe juste avant le <tab> courant --> 

<xsl lelement name="{$eleinentName}"> 

<field> 
<!-- 

ici placer la traduction de SelementName, 
obtenue par un dictionnaire 

--> 
</field> 

<type> 

<!-- ici: typeSQL = le texte situe juste apres le <tab> courant --> 

<xsl :choose> 

<xsl :when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl :when test="contains( $typeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 
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<xsl:when test="containsC StypeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 

</type> 

</xsl :eleinent> 

</xsl :for-each> 

Le programme de fusion-synthese des documents tables. xmi et fieids.xmi est done 
celui-ci : 

mapping.xsl 

<?xml version=''1.0'' encocling=''UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl = "http: / /www. w3.org/1999/XSL/Transforni" 

version=''1.0"> 

<xsl:output method='xml ' indent="yes" encoding=' ISO-8859-r /> 
<xsl :param name="dicoFileRef">fields.xnil</xsl :param> 

<xsl ivariable name=''Dictionnaire" select="document($dicoFileRef )/fields"/> 

<xsl : tempi ate inatch="/"> 
<mapping> 

<xsl :apply-templates/> 
</mapping> 
</xsl :teniplate> 



<xsl itemplate name="traduction"> 
<xsl:param name="motId"/> 

<xsl ivariable 

nanie=''saTraduction" 

select="$Dictionnaire/field[@id=$motId]" /> 

<xsl :value-of select="normalize-space($saTraduction)" /> 
</xsl :template> 

<xsl : tempi ate match="tabl e''> 
<table> 

<xsl :value-of sel ect="@name"/> 
</table> 

<xsl:element name="{@name}"> 
<xsl :for-each select="tab"> 
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<xsl ivariable name="el ementName" 

select=" normal ize- space ( 

preceding-sibl ing: : text( ) [1] 
)"/> 

<xsl lelement name="{$eleinentName}"> 
<field> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="inotId" sel ect="$el ementName" /> 

</xsl :call-template> 
</field> 
<type> 

<xsl ivariable name="typeSQL" select="normalize-space( 

fol 1 owing-sibl ing: : text( ) [1] 
)"/> 

<xsl :choose> 

<xsl:when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test^'containsC StypeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 

<xsl:when test^'containsC StypeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :element> 

</xsl :for-each> 
</xsl :element> 

</xsl :templ ate> 



<xsl :templ ate match="text( ) "/> 
</xsl :stylesheet> 

On obtientcommeresultatlefichier mapping. xmi montreau debut de la section Exemple 
plus evolue, page 275. 

Variante syntaxique namespace="..." 

Onpeutsi I 'on veut aj outer un attri but namespace, commececi : 

xsl : element 

I <xsl : element name="..." namespace=" . . . "> 
<!-- modele de transformation --> 
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<!-- fin du modele de transformation --> 
</xsl :element> 

L'attribut namespace (une chalne de caracteres) permet d'affecter un domaine nominal a 
I'elementqui va etrecree. Un descripteurdevaleurdiffereed'attribut estaccepte ici. La 
chaine de caracteres qui constitue le domaine nominal n'est pas analysee par le proces- 
seur XSLT, done aucun controlede validite de cette chaine n'est effectue, 

Notons d'emblee que la maniere la plus simple d'affecter un domaine nominal aux ele- 
ments XM L crees par un programme XSLT n'est pas d'uti I iser I 'instruction xsi : element 

avec l'attribut namespace . 

Exemple sans namespace-'..." 

N ous reprenons ici I 'exemple vu a la section Suite de I 'exemple, page 270, et nous suppo- 
sons que le domaine nominal des elements a generer doit etre "http://concerts.ana- 
creon.org/vioie-de-gambe", et que ce domaine nominal est un domaine par defaut. 
Dans ce cas, il n'a y presque rien a faire, si ce n'est de declarer le domaine nominal en 
question dans la racine du programme : 

fusion. xsi 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl istylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

xmlns=" http://concerts.anac reon.fr/viole-de-gambe" 

vers1on="1.0"> 

<xsl:output method^'xml' indent="yes" encodings' ISO-8859-r /> 
<xsl:parain naine="declamationFileRef" select^" 'declamationTaille.xml ' " /> 
<xsl :variable name="declaination" 

sel ect="document( $declamationFileRef )/texte" /> 

<xsl :templ ate match="/"> 

<recitant> 

<xsl :apply-teinplates/> 

</recitant> 
</xsl :templ ate> 

<xsl :template match="prol ogue"> 
<prol ogue> 

<xsl :value-of select="$declamation/titre"/> 
</prologue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 

<xsl :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="pos1tion( )" /> 
<mesure No=" { . )"> 

<xsl :val ue-of select="$declaination/paroles/p[position( )=$i]"/> 
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</mesure> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant xmlns=" http://concerts.anacreon.fr/viole-cle-gambe"> 
<prol ogue> 

Le Tableau de I'Operation de la Taille 

</prologue> 

<mesure No="l">L' aspect de I'apareil .</mesure> 
<mesure No="8">Fremissement en le voyant.</mesure> 
<mesure No="ll">Resolution pour y nionter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</niesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jainbes.</mesure> 
<mesure No="27">Icy se fait 1 'incision. </mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici I'on tire la piere.</niesure> 
<mesure No="44">Icy I'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</inesure> 
<mesure No="50">Icy I'on oste les soyes. </mesure> 
<mesure No="53">Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 

L'element<recitant> a ete equi pe d'un attribut xmi ns qui donne le domaine nominal par 
defaut, et toute la descendance (enfants, petits-enfants, etc.) herite de ce domaine nomi- 
nal par defaut. Les elements <proiogue> et <mesure> sont done eux aussi dans le 

domaine nominal http: //concerts . anacreon . f r/viol e-de-gambe. 

Autre exemple sans namespace-'..." 

Une autre possibilite est de declarer un domaine nominal explicite pour chaque element 
cree. Cela se faittres simplementen donnantexplicitement leprefixe (ou abreviation) du 
domaine nominal a utiliser, a condition que ce domaine ait ete declare et soit visible a 
I'endroit ou I'abreviation est utilisee : 

fusion.xsl 

<?xml version="1.0" encoding=''UTF-16"?> 
. <xsl istylesheet 

xinlns:xsl=" http: //www. w3.org/1999/XSL/Transform" 
xinlns:vdg=" http: //concerts, anacreon.fr/ viol e-de-gambe" 
versiDn="1.0"> 

<xsl:output method^'xml' indent="yes" encoding='IS0-8859-r /> 
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<xsl:param naine="declamationFileRef" select="'declamationTaille.xmr" /> 
<xsl :variable name="declamation" 

sel ect="docunient( $declamationFileRef )/texte" /> 

<xsl : tempi ate match="/"> 
<vdg:recitant> 

<xsl :apply-teinplates/> 
</vdg:recitant> 
</xsl itempl ate> 

<xsl itemplate niatch="prol ogue"> 
<vdg:prologue> 

<xsl :value-of select="$declamation/titre"/> 
</vdg:prologue> 
</xsl :templ ate> 

<xsl : tempi ate match="Numeros"> 

<xs1 :for-each sel ect="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<vdg:mesure No=" { . }"> 

<xsl :val ue-of select="$declamati on/pa roles/p[positi on ( )=$i]"/> 
</vdg:mesure> 
</xsl :for-each> 
</xsl itempl ate> 

<xsl itemplate match="text( )"/> 
</xsl :stylesheet> 

R esultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<vdg:recitant xmlns:vdg=" http://concerts.anacreon.fr/viole-de-gambe"> 
<vdg:prologue> 
Le Tableau de 1 'Operation de la Taille 
</vdg:prologue> 
<vdg:mesure No="l">L'aspect de 1 'apareil .</vdg:mesure> 
<vdg:mesure No="8">Fremi ssement en le voyant.</vdg:mesure> 
<vdg:mesure No="ll">Resol ution pour y monter.</vdg:mesure> 
<vdg:mesure No=''15">Parvenu jusqu'au hault;</vdg:mesure> 
<vdg:mesure No="20">descente dudit apareil .</vdg:mesure> 
<vdg:mesure No="22">Reflexions serieuses.</vdg:mesure> 
<vdg:mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</vdg:mesure> 
<vdg:mesure No="27">Icy se fait 1 ' incision. </vdg:mesure> 
<vdg:mesure No="31">Introduction de la tenette.</vdg:mesure> 
<vdg:mesure No="39">Ici I'on tire la piere.</vdg:mesure> 
<vdg:mesure No="44">Icy I'on perd quasi la voix.</vdg:mesure> 
<vdg:mesure No="48''>Ecoul ement du sang.</vdg:mesure> 
<vdg:mesure No=''50''>Icy I'on oste les soyes. </vdg:mesure> 
<vdg:mesure No="53">Icy I'on vous transporte dans le lit.</vdg:mesure> 
</vdg:recitant> 
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Exemple avec namespace="..." 

Enfin, nous en arrivons a une solution oil on utiliseeffectivement I'attribut namespace de 

^instruction xsl :element : 
fusion.xsl 

I <?xml version="1.0" encocling="LITF-16"?> 
<xsl rstylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method^'xml ' indent="yes" encoding='IS0-8859-r /> 
<xsl:param nanie="declamationFileRef" select=" 'decl amationTai 1 1 e.xml ' " /> 
<xsl ivariable naine="declaniation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl itempl ate match="/"> 

<recitant> 

<xsl :apply-teniplates/> 

</recitant> 
</xsl :templ ate> 

<xsl :templ ate match="prologue"> 
<prologue> 

<xsl :value-of select="$declaination/titre"/> 
</prol ogue> 
</xsl :templ ate> 

<xsl itemplate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl ivariable naine="i" select="position( )" /> 
<xsl:element name="niesure" 

namespace=" http://concerts.anacreon.fr/viole-de-gambe"> 
<xsl lattribute nanie="No"><xsl :val ue-of select="."/> 
</xsl :attr1bute> 

<xsl :value-of select="$declamation/paroles/p[positiDn( )=$i]"/> 
</xsl :element> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :templ ate match="text( ) "/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 

Le Tableau de I'Operatlon de la Tallle 

</prologue> 

<mesure xml ns="http: //concerts .anacreon .fr/viol e-de-gambe" No="l"> 
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L'aspect de 1 'apareil .</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="8"> 

Fremissement en le voyant.</inesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="ll"> 

Resolution pour y monter.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="15"> 

Parvenu jusqu'au hault;</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="20"> 

descente dudit apareil .</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="22"> 

Reflexions serieuses.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="23"> 

Entrel assement des soyes 
Entre les bras et les jambes.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="27"> 

Icy se fait 1 'incision. </mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="31"> 

Introduction de la tenette.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="39"> 

Ici I'on tire la piere.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="44"> 

Icy I'on perd quasi la voix.</mesure> 

<mesure xmlns="http: //concerts . anacreon.fr/viol e-de-gambe" No="48"> 

Ecoulement du sang.</mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="50"> 

Icy I'on oste les soyes. </mesure> 

<mesure xmlns=" http://concerts.anacreon.fr/ viol e-de-gambe" No="53"> 

Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 

Ici, il n'y a pas grand interet a proceder de la sorte, puisque I'element <mesure> n'a pas 
d'element fils. Le domaine nominal par defaut est inutilement repete pour chaque 
<mesure>, alors qu'il aurait ete plus simple, comme on I'a vu plus haut, de declarer ce 
domaine nominal par defaut directement sur I'element racine <recitant>. 



Variante syntaxique use-attribute-sets="..." 

Cet attribut va de pair avec I'instruction xsi :attribute-set, qui sera etudiee plus loin 
(voir Instruction xsl: attribute-set, page 304). 



Instruction xshattribute 

Bande-annonce 

Concert.xml 

|<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Concert> 
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<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapene des Llrsules</Lieu> 

<Enseinble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Noin> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrunient>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 
<Compositeur>M 
<Compositeur>D 
<Compositeur>F 
</Compositeurs> 

</Concert> 

Concert.xsl 

[ <?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xml' encodings' ISO-8859-r indent^'yes' /> 

<xsl :templ ate match="/"> 

<Interpretes> 

<xsl : apply-templ ates/> 

</Interpretes> 
</xsl :templ ate> 

<xsl itemplate match=" Interprete"> 
<Interprete> 

<xsl :attribute name="Nom"> 

<xsl :value-of select="./Nom"/> 



. Marais</Compositeur> 
. Castello</Compositeur> 
. Rognoni</Compositeur> 
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</xsl :attribute> 

<xsl :attribute naine="Instrument"> 

<xsl :value-of sel ect=" . /Instrument"/> 
</xsl :attribute> 
</Interprete> 
</xsl itempl ate> 

<xsl : tempi ate match="text( )"/> 
</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<Interpretes> 

<Interprete Noin=" Jonathan Dunford " Instrument="Basse de viole"/> 
<Interprete Noin=" Sylvia Abramowicz " Instrument="Basse de viole"/> 
<Interprete Noin=" Benjamin Perrot " Instrument="Theorbe et Guitare baroque"/> 
</Interpretes> 

Syntaxe 

L'instruction <xsi :attribute> permet de creer un nouvel attribut, dont le nom estfourni 
par I'attribut name, et la valeur par le modele de transformation associe. Elle prend la 
forme suivante : 

xsl : attribute 

<xsl : attribute naine="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl lattribute --> 
</xsl :attribute> 

L'instruction xsi :attribute ne doit pas apparaltre en tant qu'instruction de premier 
niveau. 

Regie XSLT typique 

Comme un attribut ne peut pas apparaitre isolement dans un document XM L, l'instruc- 
tion <xsi :attribute> esttoujoursassocieed'unemaniereou d' une autre a une instruction 
de creation d'element. Les deux formes syntaxiques qui suivent sont couramment 
employees pour realiser cette association. 

L'instruction <xsi :attribute> peut s'utiliser en tant que complement pour instruction 
<xsi :eiement>, qui prend alors la forme suivante : 

xsl : attribute 



<xsl:element name="..."> 

<xsl lattribute name="..."> 
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<!-- modele de transformation propre a xsl lattribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl lattribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 

... autres instructions <xsl :attribute> ... 

<!-- modele de transformation propre a xslielement --> 

<!-- fin du modele de transformation propre a xslielement --> 
</xsl :el ement> 

Les instructions <xsi :attribLite> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de instruction <xsi :eiement> ; il est interdit de les diluer 
parmi I'ensembledes enfants existants. 

instruction <xsi :attribLite> peut aussi etre utilisee pour fournir un attribut a un ele- 
mentXML faisantpartied'un element source litteral : 

xsl : attribute 

<xxx> 

<xsl lattribute name="..."> 

<!-- modele de transformation propre a xsl lattribute --> 

<!-- fin du modele de transformation propre a xsl lattribute --> 
</xsl :attribute> 
<xsl lattribute name="..."> 

<!-- modele de transformation propre a xsl lattribute --> 

<!-- fin du modele de transformation propre a xsl lattribute --> 
</xsl :attribute> 

... autres instructions <xsl :attribute> ... 

<!-- modele de transformation propre a 1 'element xxx --> 

<!-- fin du modele de transformation propre a 1 'element xxx --> 
<xxx> 

Les instructions <xsi :attribLite> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de I'element <xxx> ; il est interdit de les diluer parmi 
I'ensemble des enfants existants. 

Emploi mains typique 

Les deux formes syntaxiques que nous venons de voir pour realiser ['association entre 
attribut et element ne sont pas les deux seules possibles, ce sont seulement les plus cou- 
rantes. 
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En fait, ce qui compte, dans la realisation de cette association, ce n'est pas la proximite 
topologique et statique de deux instructions placees en regard I'une de I'autre dans le 
fichier sourceXSLT, maisia proximite temporelleetdynamique : il faut que I 'instruction 
<xsi :attribute> soit instanciee juste apres une instruction <xsi :eiement> ou une autre 

instruction <xsl :attribute>. 

Les deux formes syntaxiques vues ci-dessus permettent de fa^on evidente d'obtenir ce 
resultat, maisil y en au moins une autre, consistant a instancier instruction <xsi:eie- 
ment> dans un modele nomme, et instruction <xsi :attribute> dans un autre modele 
nomme. Dans ce cas de figure, les deux instructions <xsi :attribute> et <xsi :eiement> 
peuvent etre tres el oignees I'une de I'autre tout en etant dynamiquement associees. 

Etfinalement, il en reste encore une derniere : eel I e consistant a prendre I'une des deux 
formes typiques (voir Regie XSLT typique, page 291), et a intercaler des instructions 
quelconques entrela premiere instruction xsi : attribute et I 'element dont ell e depend, a 
condition que ces instructions ne creent rien dans le document resultat, N ous verrons cela 
dansun prochain exemple (voir Exemple plusevolue, page 295). 

Semantique 

U n nouvel attribut est cree, et attache a son element parent ; le nom de cet attribut est 
fourni par la valeur de I'attribut name, valeur qui peut, si I'on veut, etre fournie sous 
forme d'un descripteur de valeur differee d'attribut (AVT) : le nom de I'attribut n'est 
done pasforcementunechaine« en dur » dans le programme XSLT (c'estl'un desrares 
endroits, en XSLT, ou un descripteur de valeur differee d'attribut est autorise). Quant a sa 
valeur, c'est le fragment de document resultat de I'instanciation du modele de transfor- 
mation proprea I'instruction xsi :attribute en cours. Ce fragment de document resultat 
doit etre un texte ordinaire, sans aucun element XM L (pas de baliseXM L). 

Dans ce processus de creation et d'attachement d'un attribut a son element parent, ce 
n'est pas une erreur si I 'element parent possede deja un attribut de meme nom. Le dernier 
ajoute I'emporte. Nous reverrons cela un peu plus loin (voir Complements, page 319). 

Regie du pape 

Premier ajoute, premier ecrase : c'est cela la regie du pape. Autrementdit, ie dernier ajoute i'emporte, comme 
on vientde ie voir. Cette regie serta piusieurs reprises dans ia suite. 

Exemple trivial 

Le premier exemple reprend la feuille de style qui nous avions vu a la section Suite de 
I 'exemple, page 270, avec laquelle il fallait obtenir le resultat suivant : 

interventionRecitant.xinl 

|<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 
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Le Tableau de I'Operation de la Taille 
</prologue> 

<mesure No="l">L' aspect de I'apareil .</mesure> 
<mesure No="8">Freniissement en le voyant.</mesure> 
<mesure No="ll">Resolution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrel assement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27">Icy se fait 1 'incision. </mesure> 
<mesure No="31''>Introduction de la tenette.</mesure> 
<mesure No="39''>Ici I'on tire la piere.</niesure> 
<mesure No="44">Icy I'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoul ement du sang.</mesure> 
<mesure No="50''>Icy I'on oste les soyes. </mesure> 
<mesure No="53''>Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 

II est immediat de transformer la feuille de style fusion. xsi pour utiliser I'instruction 

xsl : attri bute : 



fusion.xsl 

<?xml version="1.0" encoding="LITF-16''?> 
. <xsl istylesheet 

xmlns : xsl ^'http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 



<xsl:output method^'xml ' indent^'yes" encoding='IS0-8859-r /> 
<xsl:param name="declamationFileRef" select='"declamationTaille.xml ' " /> 
<xsl :variable name="declaination" 

sel ect^'documentC $declamationFileRef )/texte" /> 



<xsl : tempi ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl itempl ate> 



<xsl :template match="prol ogue"> 
<prol ogue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl itempl ate> 

<xsl itemplate match="Numeros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl ivariable name^'i" select="position()" /> 
<!-- c'est ici que cela change --> 
<mesure> 
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<xsl :attribute name="No"> 

<xsl :val ue-of select="."/> 
<xsl :attribute/> 

<xsl :val ue-of select="$declamation/paroles/p[position() = $i]"/> 
</mesure> 
<!-- --> 
</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="text( ) "/> 
</xsl :stylesheet> 

Cette version n'apporte rien de mieux a celle que nous avions deja vue ; elle meme un 
peu moins claire a la lecture. Comme nous I'avions deja dit a propos de I'instruction 
xsi :eiement, I'instruction xsi : attri buten'est vraiment interessante que si le nom de 
I'attributestcalcule par le programme. Sinon, si c'est uniquement la valeur qui estcalcu- 
lee par le programme, autant mettre le resultat du calcul dans une variable et utiliser un 
descripteur de valeur differee d'attribut, comme nous I'avions fait dans la version prece- 
dente du programme ci-dessus (voir section Suite de I 'exemple, page 270). 



Exemple plus evolue 

Nous allons maintenant ameliorer le programme vu a la section Exemple plus evolue, 
page 275, c'est-a-dire le rendre plus conforme aux vraies attentes, qui sont en fait d'obte- 
nir un resultat tel quecelui-ci : 

mapping.xinl 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 

<ACCORD> 
<DEDEC> 

<field>beginning_clate</field> 
<type>BusinessDate</type> 
</DEDEC> 

<CCETF CHAR="1"> 

<field>state</field> 

<type>String</type> 
</CCETF> 

<NOACA CHAR="6"> 

<field>company_id</field> 

<type>String</type> 
</NOACA> 

<NOPOA VARCHAR2="35"> 

<field>contract_nbr</field> 

<type>String</type> 
</NOPOA> 

<CCPAA1 NUMBER="4"> 

<f i el d>country_code</f i el d> 
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<type>Integer</type> 
</CCPAAl> 
</ACCORD> 

<table>COMPANY</table> 
<COMPANY> 

<NOACA CHAR="6"> 

<f i el d>company_i d</f i el cl> 
<type>Stri ng</type> 
</NOACA> 

<LSACA1 VARCHAR2="35"> 

<f i el d>company_name</f i el d> 

<type>String</type> 
</LSACAl> 

<CCPAA1 NUMBER="4"> 

<f iel d>country_code</f iel d> 

<type>Integer</type> 
</CCPAAl> 

<LAACA1 VARCHAR2="35"> 

<field>address</field> 

<type>String</type> 
</LAACAl> 

<URL VARCHAR2="40"> 

<field>URL</field> 

<type>String</type> 
</URL> 

<STATRAT VARCHAR2="1"> 

<field>qual ity_code</field> 
<type>String</type> 
</STATRAT> 
</COMPANY> 
</niapping> 

II s'agit done d'ajouter a chaque element un attribut donnant son type SQL ainsi que sa 
longueur, sauf si la longueur n'est pas une information pertinente (cela ne concerne que 
les dates, dans notreexemple : I'element <dedec>). 

Le changement est tres simple a effectuer, car la structure du programme XSLT ne 
change pas. Par commodite, nous al I onstoutefois declarer des variables qui contiendront 
le nom et la valeur de ces nouveaux attributs aemettredans le document resultat. 

La regie princi pale du programmeXSLT que nous avions mis au pointetaitcelle-ci : 

<xsl : tempi ate niatch="tabl e"> 
<table> 

<xsl :val ue-of sel ect="@name"/> 
</table> 

<xsl:element nartie="{@name}"> 
<xsl :for-each sel ect="tab"> 

<xsl :variable name="el ementName" 
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sel ect= "normal ize-space( 

preceding-sibling: :text()[l] 
)"/> 

<xsl :element name=" {$el ementName} "> 



<field> 

<xsl : call -tempi ate name="traduction"> 

<xsl :with-param name="motId" select="$elementName" /> 

</xsl :call-template> 
</field> 
<type> 

<xsl :variable name="typeSQL" select="normalize-spaceC 

foil owing- sibling: :text()[l] 
)"/> 

<xsl :chDose> 

<xsl :when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 



<xsl :when test="contains( $typeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 



<xsl:when test="contains( $typeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :el ement> 



</xsl :for-each> 
</xsl :element> 



</xsl :templ ate> 

Etant donne la chalne de caracteres "number(4)" par example, valeur de la variable 
typeSQL, le nom du type proprement dit est donne par I'expression substring-beforec 
$typeSQL. '(' ), c'est-a-dlre la sous-chaine qui s'arrete juste avant la 'C. 

La fonction substring-beforec ) est une fonction standard XSLT, I'une des rares qui 
permettededecortiquer uneString, Ellea son symetrique, substring-afterc ), qui va lui 
aussi nous servir : 

<xsl :variable name="typeSQL" select="normalize-space( 

following-sibling: :text()[l] 
)"/> 



<!-- ici, typeSQL vaut par exemple "NUMBER(4)" --> 

<xsl :variable name="attributeName" 

select="substring-before( $typeSQL, '(' )"/> 
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<!-- dans ce cas, attributeName vaut "NUMBER" --> 

<xsl :variable naine="typeSQL-after" 

select="substring-after( $typeSQL, '(' )"/> 

<!-- et typeSQL-after vaut "4)" --> 

<xsl :variable naine="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

<!-- et finalement attributeValue vaut "4" --> 

A I'issue de ces instanciations de variables, on tient le nom et la valeur de Tattribut cou- 
rant. M ais 11 faut verifier que ce nom n'est pas une chaine vide, car I'instanciation d'un 
attribut dont le nom est vide n'a clairement aucun sens, et provoque uneerreur. 

Or, il peut arriver que le nom soit vide, parce que la fonction substring-beforec ) ren- 
voie une chalne vide si le marqueur recherche, une "(" dans notre exemple, n'existe pas 
dans la chalne examinee. Et de fait, cela se produira pour le type date, qui ne mentionne 
pas de longueur, 

<xsl :variable naine="typeSQL" select="norinalize-space( 

fol 1 owing-si bl ing: : text ( )[1] 
)"/> 

<xsl :variable naine="attributeName" 

select="substring-before( $typeSQL, '(' )"/> 

<xsl :variable naine="typeSQL-after" 

select="substring-after( $typeSQL, '(' )"/> 

<xsl :variable naine="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

<xsl:if test="$attributeName"> 

<xsl :attribute name="{$attributeName}" > 
<xsl :value-of select="$attributeValue"/> 

</xsl :attribute> 
</xsl :if> 

La valeur de I'attribut test est convertie en booleen ; on rappelle (voir Fonctions Boo- 
le'ennes, page 636) que la conversion d'une String en booleen donne true si et seulement 
si la String n'est pas de longueur nulle, d'oii le test ci-dessus. 

L e programme X SLT se deduit de toutes ces remarques, et donne bien le resultat montre 
au debut decette section, 

mapping.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 
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xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output methocl='xinl ' indent="yes" encoding=' ISO-8859-1 ' /> 
<xsl :param name="dicoFileRef">fields.xnil</xsl :param> 

<xsl :variable name="Dictionnaire" select="document($dicoFileRef )/fields"/> 

<xsl : tempi ate match="/"> 
<mapping> 

<xsl :apply-templates/> 
</mapping> 
</xsl :template> 



<xsl :template name="traduction"> 
<xsl:param name="motId"/> 



<xsl ivariable 

name="saTraduction" 

select="$Dictionnaire/field[@id=$motId]" /> 



<xsl :value-of select="normalize-space($saTraduction)" /> 
</xsl :template> 



<xsl :template match="tabl e"> 
<table> 

<xsl :val ue-of sel ect="@name"/> 
</table> 



<xsl:element name="{@name)"> 



<xsl : for-each select="tab"> 



<xsl ivariable name="elementName" 

sel ect=" normal ize-space( 

preceding-si bl ing: :text( ) [1] 
)"/> 

<xsl lelement name=" {$el ementName} "> 

<xsl ivariable name="typeSQL" select="normalize-space( 

fol 1 owing- si bl ing: : text( ) [1] 
)"/> 



<xsl :variable name="attributeName" 

select="substring-before( $typeSQL, '(' )"/> 

<xsl ivariable name="typeSQL-after" 

select="substring-after( $typeSQL, '(' )"/> 

<xsl ivariable name="attributeVal ue" 

select="substring-before( $typeSQL-after, ')' )"/> 
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<xsl:if test="$attributeName"> 

<xsl :attribute name="{$attributeName}" > 

<xsl :value-of select="$attributeValue"/> 
</xsl :attribute> 

</xsl :if> 

<field> 

<xsl :call-template name="traduction"> 

<xsl :with-param name="inotId" sel ect="$el ementName" /> 
</xsl :call-template> 
</field> 

<type> 

<xsl :choose> 

<xsl:when test="contains( $typeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test="contains( $typeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 

<xsl:when test="contains( $typeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :element> 

</xsl :for-each> 
</xsl :element> 

</xsl :templ ate> 



<xsl itempl ate match=''text( ) "/> 
</xsl :stylesheet> 

Variante syntaxique namespace="..." 

Onpeutsi I'on veutajouterun attri but namespace, commececi : 

xsl : attribute 

<xsl :attribute name^"..." namespace^" . . . "> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :el ement> 
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L'attribut namespace (une chaine de caracteres) permet d'affecter un domaine nominal 
a l'attribut qui va etre cree. Un descripteur de valeur differee d'attribut est accepte ici. 
La chaine de caracteres qui constitue le domaine nominale n'est pas analysee par le pro- 
cesseur XSLT, done aucun controle de validite de cette chaine n'est effectue. 



Exemple avec namespace="..." 

Nous reprenons I'exemple vu a la section Exemple avec namespace="...", page 288, dans 
lequel nous declarons un domaine nominal uniquement pour l'attribut : 

mapping.xsl 

<?xml version="1.0" encocling="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl ="http: / /www. w3.org/1999/XSL/Transforni" 

version="1.0"> 

<xsl:output methocl='xinl ' indent="yes" encoding=' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " sel ect=" 'decl amationTai 1 le.xml' " /> 
<xsl ivariable name="declamation" 

sel ect="docuinent( SdeclamationFileRef )/texte" /> 

<xsl :template inatch="/"> 
<recitant> 

<xsl :apply-templates/> 
</recitant> 
</xsl itempl ate> 

<xsl itemplate inatch="prol ogue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prol ogue> 
</xsl itempl ate> 

<xsl itempl ate match="Nunieros"> 
<xsl ifor-each sel ect="NoMesure"> 

<xsl ivariable name="i" select="position( )" /> 
<xslielement name="mesure" > 
<xsl lattribute name="No" 

namespace="http I //concerts. anacreon.fr/viole-de-ganibe"> 
<xsl ival ue-of select="."/> 
</xsl :attribute> 

<xsl ivalue-of select="$declamation/paroles/p[position() = $i]"/> 
</xsl ielenient> 
</xsl ifor-each> 
</xsl itempl ate> 

<xsl itemplate niatch="text( )"/> 
</xsl istylesheet> 
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Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 

Le Tableau de I'Operation de la Taille 

</prologue> 

<mesure xinlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="l"> 

L'aspect de 1 'apareil .</mesure> 
<mesure xinlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="8"> 

Fremissement en le voyant.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="ir'> 

Resolution pour y monter.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="15"> 

Parvenu jusqu'au hault;</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="20"> 

descente dudit apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="22"> 

Reflexions serieuses.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="23"> 

Entrel assement des soyes 
Entre les bras et les jambes.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="27"> 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="3r'> 

Introduction de la tenette.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="39"> 

Ici I'on tire la piere.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="44"> 

Icy I'on perd quasi la voix.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="48"> 

Ecoulement du sang.</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="50"> 

Icy I'on oste les soyes .</mesure> 
<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="53"> 

Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 

On voit qu'ici, le processeur XSLT a ete oblige d'inventer une abreviation pour le 
domaine nominal choisi, car la declaration xmins=" . . . " prend place dans I'element 
<mesure>, mais ne doit pas pour autant s'appliquer a cet element. Si le domaine nominal 
avait ete declare sans abreviation, cela aurait ete un domaine nominal par defaut, qui se 
serait done applique a I'element <mesure> lui-meme, chose que I'on veut precisement 
eviter. 

M ais la encore, 11 reste plus simple de declarer le domaine nominal souhaite (avec son 
abreviation) dans la racinedu programme XSLT, et d'uti I iserexplicitementcette abrevia- 
tion partout oil c'est necessaire, commedans I'exemplede la section Autre exemple sans 
namespace="...", page 286. 
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mapping.xsl 

<?xnil version="1.0" encocling="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl = "http: / /www. w3.org/1999/XSL/Transforni" 
xinlns:vdg=" http://concerts.anacreon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method='xinl ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:parain name="declamationFileRef " select="'declamationTaille.xnil '" /> 
<xsl :variable name="declamation" 

sel ect="docuinent( SdeclamationFileRef )/texte" /> 

<xsl itemplate match="/"> 
<recitant> 

<xsl : apply-templ ates/> 
</recitant> 
</xsl :templ ate> 

<xsl itemplate match 
<prologue> 

<xsl :value-of 
</prol ogue> 
</xsl itempl ate> 

<xsl :template match="Numeros"> 
<xsl :for-each sel ect="NoMesure"> 

<xsl ivariable name="i" select="position()" /> 
<xsl:element name="mesure" > 
<xsl lattribute name="vdg:No"> 
<xsl :val ue-of select="."/> 
</xsl :attribute> 

<xsl :val ue-of select="$declamation/paroles/p[position() = $i]"/> 
</xsl :element> 
</xsl :for-each> 
</xsl itempl ate> 

<xsl itemplate match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<recitant xml ns:vdg=" http://concerts.anacreon.fr/viole-de-gambe"> 
<prol ogue> 
Le Tableau de 1 'Operation de la Taille 
</prol ogue> 

<mesure vdg:No="r'>L'aspect de 1 'apareil .</mesure> 
<mesure vdg:No="8">Fremissement en le voyant.</mesure> 
<mesure vdg:No="ll">Resolution pour y monter.</mesure> 
<mesure vdg: No="15">Parvenu jusqu'au hault;</mesure> 
<mesure vdg: No="20">descente dudit apareil .</mesure> 



="prol ogue"> 
select="$decl amation/ti tre"/> 
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<mesure vdg:No="22">Reflexions serieuses.</mesure> 
<mesure vclg:No="23">Entrelasseinent des soyes 
Entre les bras et les jambes . </mesure> 
<mesure vdg:No="27">Icy se fait 1 'incision. </niesure> 
<mesure vdg:No="31">Introduction de la tenette.</mesure> 
<mesure vdg:No="39''>Ici I'on tire la p1ere.</niesure> 
<mesure vdg:No="44''>Icy I'on perd quasi la voix.</mesure> 
<mesure vdg:No="48''>Ecoulenient du sang.</mesure> 
<mesure vdg:No="50''>Icy I'on oste les soyes. </mesure> 
<mesure vdg:No="53">Icy I'on vous transporte dans le 11t.</mesure> 
</recitant> 
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Concert.xtnl 

<?xml version="1.0" encoding=''LITF-16'' standal one="yes"?> 
<Concert> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeud1 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Llrsules</Lieu> 

<Enseinble> "A deux violes esgales" </Ensemble> 

</Concert> 

L'instruction <xsi :attribute-set name=''..."> est utiliseG pour definir des groupe- 
ments d'attributs qui reviennent en plusieurs endroits d'un programme, lors de I'instan- 
ciation d'elements (par l'instruction <xsi :eiement> ) dans le document resultat. Le 
regroupement de la definition decesattributsfacilite la maintenance ou les evolutions du 
programme. 

Concert.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" vers1on="1.0"> 
<xsl:output method^'html ' encoding='IS0-8859-r /> 



<xsl :attribute-set name="body-attr1butes"> 

<xsl lattribute name="leftmargin">150</xsl :attribute> 
<xsl :attribute name="bgcol or">#ddeef f</xsl :attribute> 
<xsl :attribute name="text">bl ack</xsl :attribute> 

</xsl :attr1bute-set> 
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<xsl : tempi ate niatch="/"> 
<html> 
<heacl> 

<ti tl eXxsl : val ue-of sel ect= " /Concert /Entete"/></title> 
</head> 

<xsl :element name="body" use-attribute-sets="body-attributes"> 

<xsl :apply-templates/> 
</xsl :el einent> 
</html> 
</xsl rtempl ate> 

<xsl : tempi ate match="Ensembl e"> 

<H2 align="center"> Ensemble <xsl :value-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 



</xsl :stylesheet> 

Resultat 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> «Les Concerts d'Anacréon» </title> 
</head> 

<body leftmargin="150" bgcol or="#ddeeff " text="bl ack"> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
</body> 
</html> 

Syntaxe 

L'instruction <xsi :attribute-set> permet de definir un ensemble d'attributs qui pour- 
ront etre attaches en une seule fois a un element en utilisant l'instruction <xs:eiement 
name=" ..." use-attri bute-sets=" . . . ">, ou bien en utilisant un element source litteral 
avec un attribut xsi : use-attri bute-sets=" ..." (voIr Variante de I 'exemple, page 312), 

Note 

II y a aussi une autre instruction qui peututiliserrattribut use-attribute-sets dans le meme but, c'est l'instruc- 
tion <xsi : copy>, que nous verrons plus loin (voir Instruction xshcopy, page 321). Attention a ne pas confondre 
<xsi :copy> et<xsi :copy-of>, dejavue (voir Instruction xsl:copy-of, page 156). 

xsi :attribute-set 

<xsl :attribute-set name=" . . . "> 

<!-- modele de transformation propre a xsi :attribute-set --> 
<xsl :attribute name="..."> 
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<!-- modele de transformation propre a xsl lattribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl :attribute name="..."> 

<!-- modele de transformation propre a xsl :attr1bute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 

<!-- etc. autant d'attributs que I'on veut, mais rien que des attributs --> 
<!-- fin du modele de transformation propre a xsl :attribute-set --> 
</xsl :attribute-set> 

L'instruction xsi : attribute-set doit apparaitre en tantqu' instruct! on de premier niveau. 



Semantique 

L'instanciation d'une instruction xsi :attribute-set consiste a instancier toutes les ins- 
tructions xsi : attribute qu'el le contient. 

Bien que I'element xsi :attribute-set soit une instruction de premier niveau, comme 
I'est la definition d'une variable ou d'un parametre global, elle n'est pas instanciee en 
meme temps que les variables ou parametres globaux. 

Pour une variable global e, l'instanciation n'a lieu qu'une seulefois, avant que le moteur 
de transformation ne commence a traiter la racine du document ; le noeud contexte pour 
devaluation decette variable globale est le noeud racine de I'arbreXM L du document. 

Pour l'instruction xsi :attribute-set, I'instanciation est differee jusqu'au moment ou 
elle est effectivement necessaire a I'instanciation d'une instruction xsi:eiement 
reclamant cet attribute-set. Bien plus, I'instanciation du modele de transformation 
d'une instruction xsi :attribute-set est relancee a chaque fois qu'une instruction de 
xsl :eiement referen^ant cet attribute-set est instanciee. 

Le noeud contexte utilise pour I'instanciation d'une instruction xsi :attribute-set est le 
meme que celui qui est actif lors de I'instanciation de l'instruction xsi :eiement qui fait 

appel a cet attribute-set. 

Par exemple, ^instruction : 

<xsl :attribute-set name="truc"> 
<xsl :attribute name="machin"> 
<xsl :value-of select="."/> 
</xsl :attribute> 
<xsl lattribute name="bidul e"> 

<xsl :value-of select=" . . "/> 
</xsl :attribute> 
</xsl :attribute-set> 

peut etre reinstanciee de nombreuses fois, avec a chaque fois un noeud contexte different 
(done des valeursdifferentes pour les expressions evaluees par le select des xsi :vaiue- 
of). 
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De ce point de vue (invariance du noeud contexte entre I'appel et I'instanciation), ('ins- 
truction xsl :attribute-set 56 COmporte COmme instruction xsl:template name= 

". . .", mais avec la grande difference qu'il n'existe aucun moyen pour transmettre un 
argument ou parametre a une instruction xsi :attribute-set (la seule chose effective- 
menttransmise est done I e noeud contexte). 

Rien n'empeche pourtant une instruction xsi :attribute-set de faire reference a des 
variables ou parametres, mais etant donne les regies de visibilite (voir Regies de visibi- 
lity', page 212), ce ne peut etre que des variables ou parametres globaux, qui ont une 
valeur fixee une fois pour toutes. 

Variante syntaxique use-attribute-sets="..." 

On peut si I'on veutajouter un attribut use-attribute-sets, commececi : 

xsl :attribute-set 

<xsl :attribute-set naine="..." use-attribute-sets=" . . . "> 

<!-- modele de transformation propre a xsl :attribute-set --> 
<xsl :attribute naine="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl :attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 

<!-- etc. autant d'attributs que I'on veut, mais rien que des attributs --> 
<!-- fin du modele de transformation propre a xsl :attribute-set --> 
</xsl :attribute-set> 

L'attribut use-attribute-sets=" ..." (une ilste de noms d'attribute-set separes par 
des espaces blancs) permetde placer dans I'attribute-set en cours de construction des 
attributs provenant d'autres attribute-set. Bien sur, et comme toujours dans ce genre 
de situation, les references circulaires sont interdites, car elles sont impossibles a traiter 
et denuees de sens. 

Exemple 

Remarque 

Get exemple utilise I'instruction <xsl : element name='' ..." use-attribute-sets=". . . ">. 

On voit souvent la notion d'attibute-set illustree par des exemples dans ledomainede 
I'enricliissementtypograpliiqueen HTM L de textes a visual iser surun navigateur.Jen'ai 
jamais trouve ce genre d'exemple tres bien ciioisi, car CSS est justement fait pour 9a, et 
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c'est bien plus simple qu'avec XSLT : il suffitdedefinir un et un seul attribut class dans 
I'element concerne, et, dans un fichier a part, de definir la classe CSS correspondante 
avec toutes les combinaisons d'attributs typographiques que I'on veut. N ous allons done 
nous ecarter deliberement du domaine des attributs typographiques pour illustrer 1' utili- 
sation d'un regroupement d'attributs par attibute-set. 

Nous allons supposer ici que nous voulons creer un fichier XM L resumant les informa- 
tions de contenu des plages d'un CD, avec, pour chacune d'entre elles, les artistes qui 
interviennent, le titre de la piece jouee, et eventuellement d'autres informations encore. 
Le but est de pouvoir ensuite utiliser ce fichier comme I'une des sources d'information 
pour la realisation de la plaquette du disque, les declarations pour la perception par les 
artistes des droits surlesventes(qui peuvent etre au prorata du mi nutage de leur partici- 
pation), etc. 

Voici I'alluredece fichier (assez sparti ate, n'etant pas destine a etre affiche) : 
plagesCD.xml 

L <?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" org="fech"> 

Grave 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp"> 
Presto / Prestissimo 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded"> 

Adagio 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fiiirt" 
vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Les codes utilises sont repertories dans un autre fichier XM L, constitue a part (ce fichier 
n'intervient pas dans la transformation XSLT a realiser ; on le montre seulement pour 
fixer les idees) : 

codes PI ages .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<codes> 
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<artistes> 

<artiste icl="cplu" 
<artiste id="nspt" 
<artiste id="eblq" 
<artiste icl="fnirt" 
<artiste icl="odecl" 
<artiste id="fech" 
<artiste id="dsmp" 

</artistes> 



naine="Christine Plubeau"/> 
naine="Noelle Spieth"/> 
naine="Eric Bellocq"/> 
name="Frederic Martin"/> 
naine="Odile Edouard"/> 
name="Freddy Eichelberger"/> 
naine="David Sinipson"/> 



<instruments> 

<instrument id="vdg" 

<instrument id="clv" 

<instrument id="thb" 

<instrument id="vU" 

<instrument id="vl2" 

<instrument id="org" 

<instrument id="vlc" 

</instruments> 



name="Viole de gambe"/> 
name="Clavecin"/> 
name="Theorbe"/> 
name="Violon baroque"/> 
name="Violon baroque"/> 
name="Orgue positif"/> 
name="Violoncelle baroque"/> 



</codes> 

La transformation XSL que nous allons voir doit aboutirau ficliier piagesCD.xmi en par- 
tantdu ficliier sonates-jacquet-dig.xmi montre ci-dessous : 

sorntes-jacquet-dlg.xnil 

<?xml version="1.0" encoding="UTF-16"?> 
<sonates> 



<compositeur> 

Elizabeth Jacquet de la Guerre 
</compositeur> 

<recuei 1 > 

Manuscrit des senates en duo et trio 
copiees par Sebastien de Brossard vers 1695 
</recuei 1 > 



<sonate> 
<titre> 

Suonata IV en sol mineur a 2 Violini soli 
e Violoncello obligate con organo 
</titre> 

<mouvenient effect i f="bc-viol ons-orgue"> 

<titre>Grave</titre> 
</inouvement> 

<mouvement effecti f="tutti "> 

<titre>Presto / Prestissimo</titre> 
</inouvement> 

<mouvement ef f ecti f ="bc-vi ol ons"> 
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<ti tre>Adagio</titre> 
</mouvement> 

<mouvement effectif="tutti -orgue"> 

<titre>Presto Recit de basse</titre> 
</mouvement> 
</sonate> 

<!-- autres senates a suivre ici --> 
</sonates> 

Dans le fichier de depart de la transformation, nous avons done des attributs representant 
I'effectif par un code, la correspondance entre I e code et ce qu' il represente etant a etabi i r 
dans le programme XSLT, sur le principe suivant : 

• be (basse continue) =clavecin +violedegambe +theorbe 

• violons = les deux violons 

• tutti = be + violons +violoncelle 

Nous allons done definir un attibute-set pour ehaeune de ees eombinaisons : 

<xsl :attribute-set name="bc"> 

<xsl rattribute nanie="vdg">cpl u</xsl :attribute> 
<xsl :attribute nanie="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set nanie="vls"> 

<xsl :attribute nanie="vl l">fmrt</xsl :attribute> 

<xsl :attribute name="vl 2">oded</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set nanie="tt" use-attribute-sets="bc vls"> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl :attribute-set> 

On voit iei I'interet de I'utilisation de I'attribut use-attribute-sets pour la definition 
d'un attribute-set : On n'a pas a repeter les deelarations d'attributs faisant partie des 
groupes« be » ou « vls», eequi maintientunemeilleureeohereneedel'ensembleen eas 
de modifieation de I'un deees groupes. 

Ayant ees groupements d'attributs, on peut alors traiter le fiehier d'entree : 

<xsl itempl ate match="sonate"> 

<xsl :for-each select="mouvement"> 

<xsl : choose> 

<xsl :when test="@effectif = 'bc-violons-orgue' "> 

<xsl :el ement name="plage" Lise-attribute-sets="bc vls"> 
<xsl rattribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
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I</xsl :el ement> 
</xsl :when> 

Pour la combinaison « bc-violons-orgue», il suffit de prendre les groupements d'attri- 
buts « be » et « vis », et il ne manque plus que I'orgue, qu'on rajoute« a la main », 

Le programme de transformation est done lesuivant: 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xnir indent^'yes" encodings' ISO-8859-r /> 

<xsl :attribute-set naine="bc"> 

<xsl lattribute naine="vdg">cpl u</xsl :attribute> 

<xsl lattribute naine="cl v">nspt</xsl :attribute> 

<xsl lattribute naine="thb">eblq</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set naine="vls"> 

<xsl :attribute naine="vU">fmrt</xsl :attribute> 

<xsl lattribute naine="vl 2">oded</xsl :attribute> 
</xsl :attribute-set> 

<xsl :attribute-set naine="tt" use-attribute-sets="bc vls"> 

<xsl lattribute naine="vcl ">dsmp</xsl :attribute> 
</xsl :attribute-set> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-teinplates/> 

</pl ages> 
</xsl :templ ate> 

<xsl :template match="sonate"> 

<xsl :for-each sel ect="mouvement"> 

<xsl :choose> 

<xsl :when test="@effect1f = 'bc-violons-orgue'"> 

<xsl:element name="plage" use-attr1bute-sets="bc vls"> 
<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</xsl :el ement> 
</xsl :when> 

<xsl :when test="@effect1f = 'bc-violons' "> 

<xsl:element name="plage" use-attr1bute-sets="bc vls"> 

<xsl :val ue-of select="titre"/> 
</xsl :el einent> 
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</xsl :when> 

<xsl :when test="@effectif = 'bc-violoncel 1 e' "> 

<xsl:element name="plage" use-attribute-sets="bc"> 
<xsl :attribute name="vl c">dsmp</xsl :attribute> 
<xsl :val ue-of select="titre"/> 
</xsl :elenient> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti-orgue'"> 

<xsl :el ement name="plage" use-attribute-sets="tt"> 
<xsl lattribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</xsl :element> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti'"> 

<xsl:element name="plage" use-attribute-sets="tt"> 

<xsl :value-of select="titre"/> 
</xsl :elenient> 
</xsl :when> 
</xsl :choose> 

</xsl :for-each> 
</xsl itempl ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Le resultat obtenu est bien celui annonce plus haut (voir fichier piagesCD.xmi). On 
remarquera I 'inconvenient inevitable d'avoir a repeter I'instruction <xsi :eiement> pour 
chaque<xsi :when> : la factorisation serai t possible, a condition de ne pas utiliser I'attri- 
but use-attribute-sets, ou alors de I'utiliser avec la meme valeur partout, ce qui est 
malheureusement contradictoire avec le but poursuivi. 



Variante de I'exemple 

Remarque 

Cet exemple utilise un element source XML litteral (hors du domaine nominal « xsl ») associe a un attribut 
xsl :use-attribute-sets=" ..." (qui lui, estdans le domaine nominal « xsl »). 

Au lieu d'utiliser I'instruction <xsi :eiement> pour appeler le ou les attribute-set uti- 
les, 11 est possible d'utiliser un element source litteral, etd'employer I'attribut xsi :use- 
attri bute-sets=" . . . ", comme ceci : 

plagesCD.xsl 

|<?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 
xml ns : xsl =" http://www.w3.org/1999/XSL/Transform" 
versiDn="1.0"> 
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<xsl:output method^'xnil ' indent="yes" encodings' ISO-8859-r /> 



<xsl :attribute-set naine="bc"> 

<xsl lattribute naine="vdg">cpl u</xsl :attribute> 
<xsl :attribute naine="cl v">nspt</xsl :attribute> 
<xsl rattribute naine="thb">eblq</xsl :attribute> 

</xsl :attribute-set> 

<xsl :attribute-set naine="vls"> 

<xsl lattribute naine="vU">fmrt</xsl :attribute> 
<xsl lattribute naine="vl 2">oded</xsl :attribute> 

</xsl :attribute-set> 

<xsl :attribute-set naine="tt" use-attribute-sets="bc vls"> 

<xsl :attribute nanie="vcl ">dsnip</xsl :attribute> 
</xsl :attribute-set> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-teinplates/> 

</pl ages> 
</xsl itempl ate> 

<xsl : tempi ate match="sonate"> 

<xsl :for-each sel ect="mouvement"> 

<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</pl age> 
</xsl :when> 

<xsl :when test="@effectif = 'bc-violons' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :value-of select="titre"/> 
</pl age> 

</xsl :when> 

<xsl :when test="@effectif = 'bc-violoncelle' "> 
<plage xsl :use-attribute-sets="bc"> 

<xsl lattribute name="vl c">dsmp</xsl :attribute> 
<xsl :val ue-of select="titre"/> 
</pl age> 
</xsl :when> 

<xsl :when test="@effect1f = 'tutti-orgue'"> 
<plage xsl :use-attr1bute-sets="tt"> 

<xsl :attribute name="org">fech</xsl :attribute> 
<xsl :value-of select="titre"/> 
</pl age> 
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</xsl :when> 

<xsl :when test="@effectif = 'tutti'"> 
<plage xsl :use-attribute-sets="tt"> 
<xsl :value-of select="titre"/> 
</pl age> 
</xsl :when> 
</xsl :choose> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl itempl ate match="text( )"/> 
</xsl :stylesheet> 

L'effet de cette version est exactement le meme que dans la version precedente. Comme 
dans ce programme, i I n'yaapriori pas d'evolution envisageablequi pourraitnecessiter 
derendre variable lenom del 'element <piage>, on peuta la rigueur penser que cette ver- 
sion esttres legerement meilleure, mais la difference est tout de memeassez infime. 

Commentaire de I'exemple 

Remarque 

Cetexemple utilise un attribute-set simule parun modele nomme. 



Ceci dit, comme on I 'a deja remarque un peu plus haut, la notion d' attribute-set 
souffre peutetre un peu du manque de possibilite de parametrage. M ais il faut bien voir 
qu'un regroupement d'attributs n'est jamais qu'un regroupement d'attributs, et qu'un 
regroupement d'attributs, 5a ne doit pas etre si terrible que 5a a realiser avec les moyens 
du bord, qui sont deja assez consequents (mine de rien) : 

<xsl itempl ate naine="bc"> 

<xsl lattribute name="vdg">cpl u</xsl :attribute> 

<xsl :attribute name="cl v">nspt</xsl :attribute> 

<xsl rattribute name="thb">eblq</xsl :attribute> 
</xsl :templ ate> 

<xsl :templ ate name="vls"> 

<xsl :attribute name="vU">fmrt</xsl :attribute> 

<xsl rattribute name="vl 2">ocled</xsl :attribute> 
</xsl itempl ate> 

<xsl :templ ate name="tt"> 

<xsl : call -tempi ate nanie="bc"/> 

<xsl :cal 1 -tempi ate nanie="vl s"/> 

<xsl :attribute nanie="vcl ">dsmp</xsl :attribute> 
</xsl :template> 
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On a ici des regroupements d'attributs, qui n'ont rien a envier a ceux de la section prece- 
dente, et qui en plus, ne sont pas limites en possibilites de parametrage, puisque rien 
n'empecherait de transmettre a ces modeles nommes des arguments comme on peut le 
faire avec n'importe quel modele nomme. 

Note 

L'interdiction de circularite, dans ce cas, semble disparaTtre, puisqu'aucune interdiction de ce genre n'est asso- 
ciee aux modeles nommes, En faitelle ne disparaitpas vraiment: un modele nomme A peuteffectivementappe- 
lerun modele nomme B, qui en retour, peutappelerle modele A. On estalors dans un cas de recursion mutuelle, 
parfaitementautorisee. Mais evidemment, toute recursion, fut-elle croisee ou mutuelle, doitfinir pars'arretersur 
une certaine condition. Sinon c'estune recursion infinie, done une erreur, qui se manifestera al'execution par la 
consommation immediate de toute la memoire disponible. 

Le plus fort, c'est que si I 'on met en oeuvre une transformation avec cette fa^on de rea- 
liser les regroupements d'attributs, on aboutit a une solution globalement plus simple : 
transformation plus simple etfichierd'entree plus simple. Pourquoi ? 

Parcequeseseraitplussimplesi I'on pouvaitaj outer des attribute-sets petitapetit, au 
fur et mesure qu'on decouvre dans la source XM L des informations qui impliquent d'en 
ajouter, M alheureusement, ce n'est pas possible. II faut donner en une seule fois la liste 
des attribute-sets aprendre encompte. On pourraiteventuellement penseraconstituer 
cette liste petit a petit, sous forme d'une chalne de caracteres qui serait ensuite fournie 
comme valeur pour I'attribut use-attribute-sets (mais n'oublions pas qu'une variable 
n'est pas modifiable, qu'il n'y a pas d'iteration possible, et que la poursuite de cette idee 
exigerait la mise en place d'un modele nomme recursif) : 

I <xsl:element naire="pl age" use-attribute-sets="{$laListe)"> 

Pas de chance, I'attribut use-attribute-sets n'est pas prevu pour accepter des descrip- 
teurs de valeurs differees d'attribut ; c'est done inutile de s'acharner a contourner cette 
difficulte, c'est perdu d'avance. 

On est done oblige d'ajouter les attribute-sets en une seule fois, et c'est ce qui oblige 
le source X M L a fournir toute une sehe de codes qui donnent toute I 'i nformation neces- 
saire en une seule fois : 

<mouveinent effect 1 f="bc-viol ons-orgue"> 

<titre>Grave</t1tre> 
</inouvement> 

et non pas : 

<mouveinent> 

<titre>Grave</t1tre> 
<effectif> 

<basseContinue/> 
<violons/> 
<orgue/> 
</effectif> 
</inouvement> 
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Pourtant la deuxieme solution est plus interessante, car elle est plus souple et plus 
simple : on ajoute ou retire ce qu'on veut, sans etre oblige d'inventer un nom de combi- 
naison pourchaquecombinaison utile. 

Mais precisement, cette deuxieme solution, plus interessante, est compatible avec une 
transformation XSLT basee sur des regroupements d'attributs par model es nommes. 

Lefichier sourceXM L estmaintenantconstituecommececi : 

sonates-jacquet-d1 g.xml 

<?xml version="1.0" encoding="UTF-16"?> 
k <sonates> 

<compositeur> 

Elizabeth Jacquet de la Guerre 
</compositeur> 

<recuei 1 > 

Manuscrit des sonates en duo et trio 
copiees par Sebastien de Brossard vers 1695 
</recuei 1 > 



<sonate> 
<titre> 

Suonata IV en sol mineur a 2 Violini soli 
e Violoncello obligate con organo 
</t1tre> 
<inouvement> 

<titre>Grave</titre> 
<effectif> 

<basseCont1nue/> 
<v1olons/> 
<orgue/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Presto / Presti ssinio</titre> 
<effectif> 

<tutti/> 
</effectif> 
</mouvement> 
<inouvement> 

<titre>Adagio</titre> 
<effectif> 

<basseCont1nue/> 
<violons/> 
</effectif> 
</mouvement> 
<inouvement> 

<titre>Presto Recit de basse</titre> 
<effectif> 
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<tutti/> 
<orgue/> 
</effectif> 
</mouvement> 
</sonate> 

<!-- autres senates a suivre ici --> 
</sonates> 

Le principe pour realiser la transformation est tres simple: on instancie une <piage>, 
puis tout de suite apres, on instancie les attributs qui sont associes a cette <piage>, puis 
enfin on instancie letitre de la plage : 

<pl age> 

<xsl lapply-templates select="effectif" /> 
<xsl :val ue-of select="titre" /> 
</pl age> 

C'est instruction : 

■ <xsl lapply-templates select="effectif" /> 

qui va instancier les attributs necessaires au fur et a mesure que les elements contenus 
dans <effectif> sont decouverts. 

Comment? 

La regie (par defaut) : 

|<xsl itemplate niatch="effectif "> 
<xsl lapply-templates /> 
</xsl itempl ate> 

va relancer la recherche de motif sur les elements enfants de <effectif> ; on va done 
ecrire une regie par enfant possible. Par exemple, pour I'element <basseContinue/>, on 
va avoir la regie : 

|<xsl :template match="basseContinue"> 
<xsl :cal 1 -tempi ate name="bc"/> 
</xsl :template> 

ce qui aura pour effet d'instancier tous les attributs regroupes dans le modele nomme 
« be ». 

II suffit done d'ecrire une regie comme celle-ci pour chaque element possible enfant de 
<effectif>. On voit la souplesse que cela procure : si on enleve ou ajoute un element 
dans la description de I'effectif, 11 n'y a rien a changer dans le programme XSLT, Dans la 
solution precedente, ceia n'aurait pas ete necessairement vrai : si i'ajout ou ia suppres- 
sion avaitfait retomber sur unecombinaison deja utilisee par ailleurs, il n'y aurait rien eu 
a changer ; mais sinon, il aurait fallu ajouter un <xsi :when> dans le <xsi :choose>, cor- 
respondanta la nouvellecombinaison, 
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Si maintenant on invente une nouvelle categorie (par exemple <vents>, regroupant une 
flute et un hautbois), il y a juste a ajouter une regie : 

<xsl :templ ate match="vents"> 

<xsl : call -tempi ate name="f 1 hb"/> 
</xsl :template> 

et a creer le regroupement d'attributs correspondant : 

<xsl :templ ate name="f1hb"> 

<xsl rattribute nanie="fl ">xxx</xsl :attribute> 
<xsl :attribute name="hb">yyy</xsl :attribute> 
</xsl itempl ate> 

Le programme est done finalementcelui-ci : 

plagesCD.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl rstylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml' indent="yes" encoding='IS0-8859-r /> 



<xsl itempl ate name="bc"> 

<xsl lattribute name="vdg">cpl u</xsl :attribute> 
<xsl :attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribLite> 

</xsl itempl ate> 

<xsl itempl ate name="vls"> 

<xsl lattribute name="vl l">fmrt</xsl 
<xsl lattribute name="vl 2">oded</xsl 

</xsl itempl ate> 

<xsl itempl ate name="tt"> 

<xsl icall-template name="bc"/> 

<xsl icall-template name="vls"/> 

<xsl lattribute name="vcl ">dsmp</xsl iattribute> 
</xsl itempl ate> 



iattribute> 
iattribute> 



<xsl itempl ate match="/"> 

<plages> 

<xsl iapply-templates/> 

</pl ages> 
</xsl itempl ate> 

<xsl itempl ate match="sonate"> 

<xsl ifor-each select="mouvement"> 
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<pl age> 

<xsl lapply-templates select="effectif " /> 
<xsl :val ue-of select="titre" /> 
</pl age> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl itemplate niatch="basseContinue"> 

<xsl :cal 1 -tempi ate naine="bc"/> 
</xsl :teniplate> 

<xsl : tempi ate match="violons"> 

<xsl icall-template naine="vl s"/> 
</xsl :templ ate> 

<xsl : tempi ate match="tutti "> 

<xsl :call-template name="tt"/> 
</xsl itempl ate> 

<xsl itemplate match="orgue"> 

<xsl :attribute name="org">fech</xsl :attribute> 
</xsl :teniplate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Le resultat obtenu est exactement le meme qu'auparavant (voir fichier pi agesCD.xmi a la 
section Exemple, page 307). 



Note 

Ne trouvez-vous pas que ces plages de CD manquent terriblement de numeros ? Cela viendra ... (voirCalcul 
dlin numero d'ordre, page 349). 



Complements 

II y a un certain nombre de regies associees a ('utilisation d'un groupement d'attributs 
par instruction xsi :attribute-set. En effet, ayant compris I'utilisation de cette ins- 
truction dans un cadre general, ou tout marchecomme sur des roulettes, on en vienttout 
naturel lement a se poser des questions angoissees sur le comportement de X SLT vis a vis 
detel outel caslimiteou pathologiquequi pourraittres bien seproduire. 

Question 

Soitun elementXML en cours d'instanciation dans le document resultat. On suppose que cet element possede 
deja un attribut de nom t , et que dans la suite de I'instanciation, on decouvre a nouveau un attribut de nom t a 
ajouter a cet element Est-ce une erreur ? 
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Non, ce n'est pas une erreur. Le dernier ajoute I'emporte. Et c'est meme une technique 
classique pour surcliarger un ajout d'attribut : 

<xsl :when test="@effectif = 'bc-violons' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :attribute name="vl l">xxx</xsl :attribute> 
<xsl :val ue-of select="titre"/> 
</pl age> 
</xsl :when> 

Danscetexemple, on veut que final ement, soit ajoute a I'element <piage> un attribut vu 
qui n'ait pas sa valeur « normale», mais la valeur « xxx ». On ajoute done tous les attri- 
buts correspondant a 'bc-vioions', eton ecrase I 'attribut vi i avec un nouvel attribut de 
meme nom, mais ayant une valeur differente. 

Question 

Soit deux attribute-set differents, mettons A etB, references dans un appel d'attribute-set, comme 
ceci : use-attribute-sets="A B". Que se passe-t-il si on trouve un attribut x dans A et un attribut y dans B 
qui ontle meme nom ? 

Ici la reponse est que I 'ordre d'ajout des attributs est impose par I 'enumeration des noms 
d'attribute-set dans la liste : use-attribute-sets="A B" implique d'abord I'ajoutdes 
attributs deA, puis ceux deB . On est done ramene au cas precedent : en cas deconflit de 
nom, le dernier ajoute ecrase le malheureux qui etait deja au chaud. 

Question 

Que se passe-t-il si on trouve deux attribute-set de meme nom ? Est-ce une erreur? 

Non, ce n'est pas une erreur en general. Les deux attribute-set sont tout simplement 
fusionnes, c'est-a-dire que les attributs de I'un sont mis dans I'autre. Du coup on peut 
retomber sur un probleme de conflit de noms d'attribut en effectuant cette fusion. M ais 
cette fois le cas est plus grave, car il peut ne pas y avoir de critere valable pour decider 
lequel I'emporte sur I'autre. Si rien ne permet de trancher, c'est une erreur, mais le pro- 
cesseur XSLT n'est pas oblige de la signaler, et peut eventuellement se contenter de se 
baser sur I'ordre d'apparition des attribute-set dans le document pour determiner un 
vainqueun 

Note 

|Vlais il peutaussi y avoir un critere, base parexemple sur la precedence relative d'un attribute-set par rapport a 
I'autre, dans le cas d'une importation par <xsl:import>que Ton verra un peu plus loin (voir Instruction xshimport, 
page 381). 

Vous voyez qu'on est en train de s'enliser dans des problemes a n'en plus finir, qui sont 
dus a ce que les regies sont tres souples et tres « coulantes », ce qui fait que de nombreux 
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problemes surgissent. A chaque fois, s'il y a une solution pour s'en sortir, on I'adopte et 
on en fait une regie. M ais ceci interesse ies gens qui doivent ecrire un processeur XSLT, 
etbeaucoup moinsceux qui doivent s'en servir, parcequ'ii estbien raredesemettresoi- 
meme dans de pareiiies situations. 

De pius, tous ces probi ernes disparaissent si on adopte ia teclinique des modeles nommes 
pour fai redes regroupements d'attributs, au iieu d'utiiiser ies attribute-set, commeci- 
dessus. D'oii ia question : 

Question 

Peut-on prendre le parti d'ignorer completement la notion d'attribute-set, et d'utiiiser a la place celle de 
modele nomme regroupantdes attributs ? 

Helas, non. D'abord parcequevous pouvez tomber sur des feuiiiesde style qui utiiisent 
ies attribute-set ; ii faut donc comprendre a quoi lis servent et comment lis inter- 
viennent. Ensuite, parcequ'ii y a unecliosequ'ii est impossible de fai re avec Ies modeles 
nommes, c'est d'importer (par I'instruction <xsi :import>, que nous verrons plus loin, a 
la section Instruction xshimport, page 381) deux groupements d'attributs provenant de 
deux feuilles de style differentes, de telle sorte que cela se traduise par une fusion des 
deux groupements. (Avec deux modeles nommes importes et de meme nom, au mieux 
I'un des deux sera ignore, et au pi re, 11 y aura une erreur fatal e : la fusion de modeles 
nommes n'a aucun sens). Or la technique d'importation de feuilles de style est extreme- 
ment importante, car elle permet de modulariser et de reutiliser. 

Ceci n'empeche evidemment pas d'employer la technique des modeles nommes pour 
faire des regroupements d'attributs, qui reste parfaitementvalideen general. Mais 11 y a 
des cas ou on peut avoir reel I ement besoin d'utiiiser devrais attribute-set. 

Instruction xshcopy 

Remarque 

instruction xsl :copy n'estpas une instruction de creation commexsl : el ement ou xsl : attribute, puisque 
c'est une instruction qui permet de recopier un fragment du document source vers le document resultat Logi- 
quement, il auraitete preferable de la placer aux cotes de I'instruction xsl :copy-of, deja vue il y a assez long- 
temps (voir Instruction xsl:copy-of, page 156). Elle se trouve placee ici pour deux raisons. La premiere, c'est 
qu'elle est equivalente dans certains cas a xsl : el ement, equivalence qui va jusqu'a I'utilisation de I'attribut 
use-attribute-sets, et a xsl : attribute dans certains autres cas (mais il y a aussi des cas oil elle ne 
ressemble ni a I'une, ni a I'autre), 

La deuxieme raison est que xsl : copy est une instruction bien plus difficile a manier que xsl : copy-of , et qu'il 
auraitete premature de la presenter a la suite de xsl : copy-of : I'instruction xsl :copy est un instrument de 
precision chirurgicale, qui est a xsl : copy-of ce que le bistouri estau marteau-piqueun 
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Bande-annonce 

Concert.xtnl 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Concert> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Enseinble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Noin> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M 

<Compositeur>D 

<Compositeur>F 
</Compositeurs> 

</Concert> 

Concert.xsl 

1 <?xml version="1.0" encoding="LITF-16"?> 

<xsl istylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'xml' encoding=' ISO-8859-r indent^'yes' /> 

<xsl itempl ate match="/"> 
<Interpretes> 

<xsl :apply-templates/> 
</Interpretes> 



. Marais</Compositeur> 
. Castello</Compositeur> 
. Rognoni</Compositeur> 
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</xsl itempl ate> 

<xsl :template niatch="Interprete"> 

<xsl :copy> 

<xsl :apply-teinplates/> 

</xsl :copy> 
</xsl itempl ate> 

<xsl :template niatch="Nom"> 

<xsl :copy> 

<xsl lapply-templates mode="copie"/> 

</xsl :copy> 
</xsl itempl ate> 

<xsl itemplate match="Instrument"> 

<xsl :copy> 

<xsl lapply-templates mode="copie"/> 

</xsl :copy> 
</xsl itempl ate> 

<xsl itempl ate niatch="text( )"/> 

<xsl itempl ate match="text( )" mode="copie" > 

<xsl icopy/> 
</xsl itempl ate> 

</xsl istylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Gultare baroque</Instrument> 
</Interprete> 
</Interpretes> 

Le meme resultat au rait ete obtenu en modifiant legerement le programme commececi : 
Concert.xsl 



|<<?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet xmlnsixsl="httpi//www. w3.org/1999/XSL/Transform" vers1on="1.0"> 
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<xsl:output method^'xmr encodings' ISO-8859-r indent^'yes' /> 



<xsl itempl ate match="/"> 

<Interpretes> 

<xsl : apply-templ ates/> 

</Interpretes> 
</xsl itempl ate> 

<xsl itemplate match=" Interprete"> 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl itempl ate> 

<xsl itempl ate match="Nom"> 

<xsl icopy> 

<xsl ivalue-of select="."/> 

</xsl icopy> 
</xsl itempl ate> 

<xsl itemplate match=" Instrument"> 

<xsl icopy> 

<xsl ivalue-of select="."/> 

</xsl icopy> 
</xsl itempl ate> 

<xsl itempl ate match="text( )"/> 



</xsl istylesheet> 

Syntaxe 

L'instruction xsi icopy permet de creer dans le document resultat une copie du noeud 
courant. 

xsi :copy 

<xsl icopy> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl icopy> 

L'instruction xsi :copy nedoit pas apparaitre en tant qu'instruction de premier niveau. 

Variante syntaxique 

On peut, si I'on veut, ajouter un attribut use-attribute-sets, comme ceci : 
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xsl :copy 

<xsl :copy use-attribute-sets=". . ."> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :copy> 

Cetattributn'estpastoujoursprisen compte, cela depend dela nature du noeud courant. 
N ous verrons cela au cas par cas, dans la suite. 



Semantique 

M erne si dans tous les cas, 11 s'agit d'une copie, I'effet exact de instruction xsi :copy 
depend dela naturedu noeud courant. Les cas les plus frequents d'utilisation sontlacopie 
d'elements ou d'attributs, mais tous les autres types de noeuds (root, text, namespace, 

processing-instruction, comment) peuvent aUSSi etreCOpieS. 

L'i nStrUCtion xsl :copy peutou non comporter un modele de transformation ; dans la pra- 
tique, on pourra done trouver cette instruction sous deux formes assez typiques. 

Premiere forme : 

<xsl : tempi ate match="..."> 

<!-- modele de transformation --> 

<xsl :copy/> 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 

Deuxieme forme : 

<xsl :template match="..."> 

<!-- modele de transformation --> 

<xsl :copy> 

<!-- modele de transformation propre a xsl:copy --> 

<!-- fin du modele de transformation propre a xslicopy --> 
</xsl :copy> 

<!-- fin du modele de transformation --> 
</xsl itempl ate> 

Enfin, il est assez frequent, dans la pratique, de trouver desemplois recursifsde I'instruc- 
tion xsiicopy ; ce sont des cas ou le modele de transformation propre a xsi:copy 
contient au moins une instruction xsi :appiy-tempiates, et ou le motif de la regie qui 
comporte I 'instruction xsi : copy ratissetres large : la combinaison decesdeux proprietes 
faitqu'il y a de bonnes chances (en fonction delargeur du rateau) pour qu'une recursion 
s'amorce. Nous verrons cela dans un autre chapitre (voir Pattern n°10 - Copie non 
conforme, page 443). 
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Copie d'un nceud de type element 

Sans modele de transformation propre 

L'element courant, comme tout element, a un nom : I'effet de ^instruction xsi :copy est 
alors decreer un element de meme nom, comme si on avait utilise instruction xsi : ele- 
ment pour le creer S'il y a des declarations de domaines nominaux dans l'element cou- 
rant, elles sont copiees du meme coup ; mais c'est tout, rien d'autre n'est copie, ni les 
eventuels attributs de l'element courant, ni ses eventuels enfants. 

Voyons cela sur un exemple; nous reprenons le fichier XML obtenu comme resultat 
du programme XSLT montre a la section Exemple avec namespace="...", page 301. 
Ce fichier resultat etait le suivant : 

interventionsRecitant.xinl 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prol ogue> 

Le Tableau de I'Operation de la Taille 

</prologue> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="l"> 

L'aspect de 1 'apareil .</niesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="8"> 

Fremissement en le voyant.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="ir'> 

Resolution pour y monter.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="15"> 

Parvenu jusqu'au hault;</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="20"> 

descente dudit apareil .</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="22"> 

Reflexions serieuses.</inesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="23"> 

Entrel assement des soyes 

Entre les bras et les jainbes.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="27"> 

Icy se fait 1 'incision. </mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="3r'> 

Introduction de la tenette.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="39"> 

Id I'on tire la piere.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="44"> 

Icy I'on perd quasi la vo1x.</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" nsO:No="48"> 

Ecoulement du sang.</mesure> 

<mesure xml ns :nsO="http: //concerts . anacreon.fr/viol e-de-gambe" nsO:No="50"> 

Icy I'on oste les soyes. </mesure> 

<mesure xml ns:nsO=" http://concerts.anacreon.fr/viol e-de-gambe" nsO:No="53"> 

Icy I'on vous transporte dans le 1 it.</mesure> 
</recitant> 
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Lecontenu dece fichiern'aaucune importance; la seule chose qui compteici, estqu'il 
y a des elements avec une declaration dedomaine nominal, un attribut, et un enfant direct 
(un noeud de type text, en I 'occurrence). 

On va done les copier, et voir cequ'il en reste apres copie. Le programme XSLT esttres 
simple : 

copie .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns : xsl ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output inethod^'xnir indent="yes" encodings' ISO-8859-r /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl :apply-templates/> 

</inesures> 
</xsl itempl ate> 

<xsl :template match="inesure"> 

<xsl :copy/> 
</xsl :temp1 ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 



<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


f r/viol e 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


ganibe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 


<mesure 


xmlns 


nsO= 


"http 


//concerts 


anacreon 


fr/viole 


de- 


gambe"/> 



</mesures> 

Le resultat confirme bien ce qui etait annonce plus haut: I'element courant, lors de 
I'instanciation du modele de transformation associe a la regie <xsi :tempiate match= 
"mesure">, donne son nom et ses domaines nominaux a un nouvel element cree dans le 
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document resultat, mais ne donne rien d'autre automatiquement : I'attribut nso : no=" . . . " 
a disparu, et letexteassocie aussi, cequi fait que I 'element ainsi cree se retrouve vide. 

Avec modele de transformation propre 

Si instruction xsi :copy possede en propre un modele de transformation, tout se passe 
d'abord comme s'il n'y en avait pas. Done, comme explique ci-dessus, 11 y a creation 
d'un element de meme nom, et de memes domaines nominaux. U ne fois I'element ainsi 
cree, le modele de transformation local est instancie, cequi a pour effet de creer des nou- 
veaux noeUds(qui peuventetrede type text, element, attribute, comment, etc.) qui vont 
etre rattaches a I'element precedemment cree. 

On volt done ce qui va se passer : supposons par exemple que le modele de transforma- 
tion comporte seulement un noeud texte, ce dernier va etre instancie et attache a son 
parent dans un lien parent-enfant. 

Exemple : 

<xsl :templ ate match="mesure"> 

<xsl :copy> 

texte sur mesure 

</xsl : copy> 
</xsl itempl ate> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe"> 

texte sur mesure 
</iiiesure> 

<mesure xml ns :nsO="http: //concerts. anacreon .fr/viol e-de-gambe"> 

texte sur mesure 
</mesure> 
<!-- etc. --> 
</mesures> 

Si maintenant le modele de transformation comporte une instruction xsl : attri bute, 
comme ceci : 

<xsl :templ ate match="mesure"> 
<xsl :copy> 

<xsl lattribute name="No">23</xsl :attribute> 
</xsl :copy> 
</xsl itempl ate> 

ce sera cette fois un attribut qui sera attache a I'element : 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe" No="23"/> 
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<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-ganibe" No="23"/> 
<!-- etc. --> 
</inesures> 

Au fait, on a perdu le domaine nominal de I'attribut "No" dans la bagarre. Comment le 
faire reapparattre? En realite, ce n'est pas un problemelie a instruction xsi :copy, mais 
a xsi :attri bute. 1 1 faut ici utiliser la variante syntaxique avec attribut namespace^" ..." 
(voirVariante syntaxique namespace="...", page 300). 

De plus, il faudra utiliser un descripteur de valeur differee d'attribut, qui est autorisee 
pour cet attribut, et fournir une expression XPath qui soit egale au domaine nominal 
"nsO". Ce n'est pas le genre d'expression XPath qu'on manipuletres souvent, il est done 
preferable ici de rappeler qu'on la construit comme une expression donnant un attribut, 

mais avec I'axede localisation "namespace: : " au lieu de "attribute: :", 

<xsl : tempi ate niatch="inesure"> 
<xsl :copy> 

<xsl :attribute naine="No" namespace="{namespace: :nsO} ">23</xsl :attribute> 
</xsl :copy> 
</xsl :templ ate> 

Ici, on reclame pour I'attribut No un domaine nominal qui soit le namespace connu sous 
I'abreviation nso. 

Resultat 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"/> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"/> 
<!-- etc. --> 
</inesures> 

A titredecuriosite, voici les del ires qu'on auraitobtenus si on avait omis la notation des 
descri pteurs de valeurs differees d'attribut : 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl :attribute naine="No" namespace="namespace: :ns0">23</xsl :attribute> 
</xsl :copy> 
</xsl :templ ate> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xinlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xinlns:ns0.6=" namespace: :nsO" ns0.6:No="23"/> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xmlns:ns0.6=" namespace: :nsO" ns0.6:No="23"/> 
<!-- etc. --> 
</mesures> 
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Ou bien si on s'etait dit que le domaine nominal, c'etait « nsO », et qu'on pouvait done 
indiquer directementcette valeur : 

<xsl :templ ate match="niesure"> 
<xsl :copy> 

<xsl :attribute name="No" naniespace="ns0">23</xsl :attribute> 
</xsl :copy> 
</xsl itempl ate> 

Resultat 

<?xitil version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe" 

xmlns:ns0.6="ns0" ns0.6:No="23"/> 
<mesure xml ns :nsO="http: //concerts. anacreon .fr/viol e-de-gambe" 

xmlns:ns0.6="ns0" ns0.6:No="23"/> 
<!-- etc. --> 
</n)esures> 

Dans ces deux cas, la valeur fournie dans I'attribut nartiespace=" ..." eSt pMse pOUT une 
chaine de caracteres decrivant un nouveau domaine nominal. Normalement, une telle 
chaine a la forme d'une URL (http://etc.), mais 11 n'y aucune verification. Pour que 
cela marche, il faut donner non pas une nouvel I e valeur de domaine nominal, mais une 
valeur existante. 

La valeur existante, C'eSt http://concerts.anacreon.fr/viole-de-gambe, C'eSt-a-dlre 

la valeur du pseudo-attribut xmins:nso, commeon peutlevoiren considerant a nouveau 
I'un des elements <mesure> du document source : 

<mesure xml ns:nsO=" http://concerts.anacreon.fr/viol e-de-gambe" 
nsO:No="l"> 
L'aspect de 1 'apareil . 
</niesure> 

Si C'etait un veritable attribut, on le referencerait en ecrivant I'expression XPath 

"attribute: :xmlns:nsO", de meme qU'On eCrirait I'expression "attribute: :nsO:No" 

pour referencer la valeur del 'attribut nsO: No. M aisxmins:nso n'estpasun attribut, meme 
s'il en a la forme. C'est un domaine nominal, ou namespace, que I'on trouvesur I'axede 

localisation namespace: : et non paS attribute: :. 

Or cette expression XPath "namespace: :xmins:nsO" ne peut pas etre placee telle quelle 
comme valeur de I'attribut namespace : 

I <xsl :attribute name="No" namespace="namespace: :xnilns:ns0">23</xsl :attribute> 

SI on ecrit cela, ce n'est pas une expression XPath qui est fournie comme valeur, mais 
une simple chaine de caracteres sans signification particuliere. Pour que cette chaine soit 
reconnue comme une expression XPath aevaluer, il faut en faire un descripteurde valeur 
differee d' attribut, comme ceci : 

^ <xsl :attribute name="No" namespace="{namespace: :xmlns:ns0}>23</xsl :attribute> 



Instruction xshcopy 

Chapitre 6 



Etcettefois, c'estbon ! 

Supposons maintenant qu'on veuille aussi copier le noeud text qui se trouve attache a 
cliaque element <mesure> ; il suffit d'ajouter un noeud text de meme valeur dans le 
model e de transformation propre a instruction xsi :copy ; ce noeud text sera alors ins- 
tancie, et attache a I 'element <mesure> nouvellementcree avec un lien parent-enfant : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output inethod^'xnir indent="yes" encodings' ISO-8859-r /> 

<xsl : tempi ate match="/"> 

<mesures> 

<xsl :apply-templates/> 

</inesures> 
</xsl itempl ate> 

<xsl :template match="inesure"> 
<xsl :copy> 

<xsl :attribute naine="No" namespace="{namespace: :ns0)">23</xsl :attribute> 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

Fremissement en le voyant.</mesure> 
<!-- etc. --> 
</mesures> 

Et pour finir, si I'on veutquela valeur de I'attri but nesoit pas toujours "23", mais la vraie 
valeur, il suffit de prelever cette vraie valeur et de la fournir a instruction xsi :attri- 

bute : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns : xsi = "http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 
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<xsl:output method^'xmr indent="yes" encoding='IS0-8859-r /> 

<xsl itempl ate match="/"> 

<inesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl itempl ate match="mesure"> 
<xsl :copy> 

<xsl lattribute name="No" namespace="{namespace: :nsO}"> 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl : val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

M alheureusement, si I'on essaiecela, on n'obtientqu'un message d'erreur : 

Resultat 

Error on line 17 of copie.xsl: 

Namespace prefix nsO has not been declared 
Transformation failed: Failed to compile stylesheet. 1 error detected. 

En effet, comme le domaine nominal « nsO » intervenient dans cette feuille de style, 11 
doit etre declare. II est impossibledecontourner cette obligation ; si I'on tente dene pas 
mentionner le domaine nominal, I'expression XPath neselectionne rien du tout : 

copie.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml' 1ndent="yes" encoding='IS0-8859-r /> 

<xsl :templ ate match="/"> 

<mesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl :templ ate match="mesure"> 
<xsl :copy> 

<xsl :attribute name="No" namespace="{namespace: :nsO}"> 

<xsl :value-of select="attribute: :No"/> 
</xsl :attr1bute> 
<xsl : val ue-of select="."/> 
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</xsl :Copy> 
</xsl itempl ate> 

<xsl : tempi ate niatch="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-ganibe" nsO:No=""> 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No=""> 

Fremissement en le voyant.</inesure> 
<!-- etc. --> 
</mesures> 

La seule solution est done de declarer cedomaine nominal : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns :nsO="http: //concerts . anacreon.fr/viol e-de-gambe" 

version="1.0"> 

<xsl:output method^'xml ' indent="yes" encodings' ISO-8859-1' /> 

<xsl :template match="/"> 

<mesures> 

<xsl :apply-templates/> 

</mesures> 
</xsl :templ ate> 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl :attribute name="No" namespace="{naniespace: :nsO}"> 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl :val ue-of select="."/> 
</xsl : copy> 
</xsl itempl ate> 

<xsl :template match="text( )"/> 
</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesures xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 
<mesure nsO:No="r'>L'aspect de 1 'apareil .</mesure> 
<mesure nsO:No="8">Fremissement en le voyant.</mesure> 
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<mesure nsO:No="ll">Resolution pour y monter.</mesure> 
<mesure nsO:No="15">Parvenu jusqu'au hault;</mesure> 
<mesure nsO:No="20">clescente dudit apareil .</niesure> 
<mesure nsO:No="22">Reflexions serieuses.</mesure> 
<!-- etc. --> 
</niesures> 

L ' aspect du resultat. 

Fremissement en levoyant. 

Resolution pour y voir plus clair. 

Reflexions serieuses : pourquoi a-t-il change ? 

Soulagement en comprenant que memesi I'aspectexterne a change par rapport a I 'origi- 
nal, la signification XML reste la meme, puisqu'un domaine nominal, declare dans un 
element, est herite par tous ses descendants. 

Note 

Ce n'estpas le seul cas ou I'aspectdu resultat peutne pas correspondre exactementace que I'on attend ;mais 
si la semantique XML estcorrecte, etque la seule chose achangerestl'aspectexterne du resultat, ce n'estpas 
certain qu'il soit possible d'y parvenir Par exemple, si vous n'aimez pas les apostrophes doubles {") pour les 
attributs, etque vous preferez les simples, inutile de chercher, il n'y a aucun moyen de reglerce detail en XSLT. 
Avec di sable-output-escaping (voir section Variante syntaxique, page 260), il est possible d'empecher (dans 
certains cas) la sortie d'entites caracteres, mais si une entite caractere est emise dans le document resultat, 
vous ne pouvez pas choisir, par exemple, entre > et > qui sont considerees comme equivalentes. II est 
vrai que I'esthetique d'un fichier source peut etre d'une certaine importance, au moins pour les personnes sen- 
sibles, etque des versions ulterieures de XSLT permettront peut-etre de mieux prendre en compte les prefe- 
rences de chacun ; mais pour I'instant, quand on n'a pas ce que I'on aime, il faut aimer ce que I'on a. 

Conclusion 

Lorsque le nceud courant a copier est de type ei ement (et dans ce cas seulement), ins- 
truction xsi :copy se comporte done comme instruction xsi :eiement. Tout ce qui a ete 
vu a propos dexsl:el ement s' applique done dans ce cas. D'ailleurs, on pourrait tres bien 
recrire le programme copie.xsi dans sa version precedente, en utilisant xsi :eiement au 
lieu de xsi : copy : 

copie.xsl 

<?xml version="1.0" encoding=''LITF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

xml ns :nsO="http: //concerts .anacreon .fr/viol e-de-gambe" 

version="1.0"> 

<xsl:output method^'xml ' indent="yes" encoding='IS0-8859-r /> 



<xsl itempl ate match="/"> 
<inesLires> 
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<xsl :apply-teinplates/> 
</mesures> 
</xsl itempl ate> 

<xsl : tempi ate match="inesure"> 
<xsl:element name="mesure"> 

<xsl :attribute naine="No" namespace="{namespace: :nsO}"> 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl :attribute> 
<xsl :val ue-of select="."/> 
</xsl :el einent> 
</xsl itempl ate> 

<xsl itempl ate match="text( )"/> 
</xsl istylesheet> 

Le resultat obtenu est strictement identique au precedent. 

Cette equivalence entre xsi icopy et xsi i element lors de la copie d'un noeud de type 
element, permet donc decomprendre immediatement comment utiliser I'attributfaculta- 
tif use-attribute-sets : de fagon evidente, 11 s'utilise exactement comme pour I'ins- 
truction xsi leiement (voir Variante syntaxique use-attribute-sets="...", page 289). M ais 
encore unefois, ceci n'est vrai que si le noeud a copier est un noeud detype element. 

Copie d'un nceud de type attribute 

L'attribut courant, comme tout attribut, a un nom et une valeur : I'effet de instruction 
xsi I copy est alors de creer un attribut de meme nom et de meme valeur, comme si on 
avait utilise I 'instruction xsi lattribute (associee au modelede transformation qu'il faut 
pour que ce soit bien la bonne valeur qui soit affectee a l'attribut). Comme la valeur de 
l'attribut n'est pas modifiable par xsiicopy, un modele de transformation propre a 
xsi I copy ne sert ici a rien. Ce n'est pas uneerreur d'en fournir un, mais 11 est ignore par 
le processeur XSLT. 

Et comme un attribut ne peut pas avoir d 'attribut, l'attribut use-attribute-sets est aussi 
ignore, si jamais 11 estfourni. 

Les memes problemes deja rencontres pour xsi lattribute surviennent ici : si on essaye 
de creer un attribut dans le document resultat, alors que le noeud destinataire n'est pas de 
type element, c'est une erreur fatal e. Par contre I'ajout de plusieurs attributs de meme 
nom n'en n'est pas une : c'est le dernier ajoute qui I'emporte (n'oublions pas la regie du 
pape, voir Se'mantique, page 293). 

Pour illustrer ceci, reprenons I'exempledu fichier XM L decrivant des plages de CD (voir 
Example, page 307), etvoyonsle programme XSLT capable delereprodui re a I 'identique. 

Le fichier de depart est eel ui-ci : 

plagesCD.xinl 

|<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 
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<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" org="fech"> 



Grave 
</pl age> 



Presto 
</pl age> 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded" vlc="dsmp"> 
/ Prestissimo 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded"> 



Adagio 
</pl age> 



<pl age 



vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 



vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Et voici le programme de copie : 
copie.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 

xinlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml' indent="yes" encoding='IS0-8859-r /> 

<xsl itempl ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl :templ ate> 

<xsl itempl ate match="pl age"> 
<xsl :copy> 

<xsl :for-each select="attribute: :*"> 

<xsl :copy/> 
</xsl :for-each> 
<xsl :value-of select="."/> 
</xsl :copy> 
</xsl itempl ate> 

</xsl :stylesheet> 

Pour chaque <piage> rencontree, on cree un element de mSme nom par ('instruction 
<xsi : copy>, auQuel On accrociie autant d'attri buts qu'on en trouve dans I'element origi nal . 
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Explorer I'ensemble des attributs de cet element original peut se faire par une instruction 
xsi :for-each Qui selectionne tout ce qui est attribut du noeud courant. Le modele de 
transformation de xsi :for-each ne contient qu'une seule instruction, qui va etre instan- 
ciee avec un noeud courant qui est un attribut. Comme cette instruction est instruction 
xsi :copy, c'est un attribut qui va etre cree avec le meme nom et la meme valeur que 
I'attribut courant. Ensuite, cet attribut sera ajoute a I'element courant (une <piage>, en 
I'occurrence). 

Resultat 

<?xnil version="1.0" encocling="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" vl2="oded" 
org="fech">Grave</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fnirt" vl2="oded" 
vcl = "dsinp">Presto / Prestissimo</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fnirt" vl2="oded">Adagio</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fnirt" vl2="oded" 
vcl="dsmp" org="fech">Presto Recit de basse</pl age> 

</pl ages> 

La presentation n'est pas la meme quecelledu fichier de depart, mais on sait qu'il n'y a 
pas grand chose a faire (voir section Avec module de transformation propre, page 328). 

Une autre fagon deproceder, assez classique, serait celled : 
copie.xsl 

<?xnil version="1.0" encoding="UTF-16"?> 
<xsl istylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xinl' indent="yes" encodings' ISO-8859-r /> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl :templ ate> 

<xsl :template match="pl age"> 
<xsl :copy> 

<xsl lapply-templates select="attribute: :*"/> 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 
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<xsl :template match="attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Au lieu d'utiliserun xsi :for-each pour explorerchaqueattri but, on relancelemoteurde 
recherche de concordance de motifs en lui faisant traiter une liste de noeuds qui ne 
contient que les noeuds detype attribute attaches au noeud courant, On ajoutealors une 
regie, dont ie motif concorde avec n'importe quei noeud detype attribute : cette regie 
sera done seiectionnee par ia recherche de concordance dont on vient de parier, et son 
application se traduit par une copie de i'attribut courant. 

Le resuitat est exactement ie meme que dans ia version precedente. 
Copie d'un noeud de type namespace 

Les choses se passent a peu pres comme dans ie cas d'un attribut, car c'est vrai qu'un 
domaine nominal est assez semblable a un attribut. Le modele de transformation est 
ignore, s'il existe, de meme que I'attribut use-attribute-sets, 

Ledomaine nominal courant, comme tout domaine nominal, a un nom (i.e. leprefixe, ou 
abreviation) et une valeur (i.e. une URL) : I'effet de I 'instruction xsi :copy est alors de 
creerun domaine nominal de meme nom etde meme valeur. 

Les memes problemes deja rencontres pour xsi :attribute surviennent ici : si on essaye 
decreer un attribut dans le document resuitat, alors que le noeud destinataire n'est pas de 
type el ement, c'est une erreur fatale. 

Attention : la regie du pape ne s'applique pas, ici : c'est une erreur que devouloirajou- 
ter un domaine nominal a un element qui en possede deja un de meme nom, sauf si la 
valeur est la meme que eel ledu doublon, auquel cas lenouveau domaine nominal est tout 
simplement ignore. 

La copie de domaines nominaux doit etre terminee avant tout ajout d'attribut ou d'ele- 
ment fils a I'element parent, sinon, c'est une erreur fatale. 

En consequence, 11 est impossible de copier un element, puis son domaine nominal : en 
effet, la copie d'un element entraine automatiquement celle de ses domaines nominaux. 
Nous allons done proceder d'une maniere legerement differente, pour ill ustrer la copie de 
domaines nominaux a travers un exemple. 

Nous prendrons le fichier qui nous a deja servi plusieurs fois : 
taille.xiiil 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesures xnilns:nsO=" http://concerts.anacreon.fr/viole-cle-gainbe"> 

<mesure nsO:No="l">L'aspect de 1 ' aparei 1 . </mesure> 

<mesure nsO:No="8">Fremissement en le voyant.</mesure> 

<!-- etc. --> 
</niesures> 
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Voici un programme de copie : 
copie.xsl 

<?xml version="1.0" encocling="UTF-16"?> 
<xsl rstylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'xml ' indent="yes" encoding='IS0-8859-l' /> 

<xsl : tempi ate match="/"> 
<paroles> 

<xsl :for-each select="child: imesures/namespace: :*"> 

<xsl :copy/> 
</xsl :for-each> 
</parol es> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat 

I <?xml version="1.0" encoding="IS0-8859-l"?> 

<pa roles xmlns:nsO="http: //concerts. anacreon.fr/viole-de-gambe"/> 

Ici la copie cree un domaine nominal de nom nso et de valeur : 

http: //concerts .anacreon.fr/viol e-de-gambe 

puisque le noeud courant est un domaine nominal, grace au xsi :for-each, Ce domaine 
nominal estajouteal'element<paroies>, c'est-a-direcelui qui est en cours de creation, 

Copie du nceud de type root 

Si le noeud courant lors de I'execution de instruction xsi :copy est le noeud root, le 
model ede transformation associe a xsi :copy, s'il y en a un, est instancie. M ais la racine 
n'est pas copiee, parce que la racine de I'arbre X M L du resultat est toujours creee auto- 
matiquement, au debut du traitement, et qu'il ne s'agirait pas d'en creer une deuxieme. 
Un eventuel attribut use-attribute-sets est bien sur ignore. 

Prenons par exemple le programme X SLT suivant : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns :xsl=" http: //www. w3.org/1999/XSL/Transform" 

vers1on="l .0"> 

<xsl:output method='xml' indent="yes" encodings' ISO-8859-1' /> 
<xsl itemplate match="/"> 
<xsl :copy> 
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<truc> 

abed 
</truc> 
</xsl :Copy> 

</xsl :templ ate> 

</xsl :stylesheet> 

Quel que soit le fichier XML donne, le resultat est le suivant : 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<truc> 

abed 
</truc> 

On voit bien qu'effectivement I'instruction xsi :copy en elle-meme est inutile, et qu'on 
aurait pu negarder que lemodelede transformation associe, cequi aurait donne lememe 
resultat. 

Copie d'un nceud de type text 

Le texte est copie dans le document resultat. Le modele de transformation de xsl : copy 
est ignore, ainsi que I'attribut use-attribute-sets, 

Copie d'un noeud de type comment 

Le commentaire est copie dans le document resultat. Le modele de transformation de 
xsl :copy est ignore, ainsi que I'attribut use-attribute-sets, 

Copie d'un noeud de type processing-instruction 

La processing-instruction est copiee dans le document resultat. Lemodelede transforma- 
tion dexsi :copy est ignore, ainsi que I'attribut use-attribute-sets. 

Instruction xshcomment 

Syntaxe 

L'instruCtion xsl:comment permet de creer un commentaire XML dans le document 
resultat. 

xsl icominent 

<xsl :comment> 

<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :comment> 

L'instruCtion xsi : comment ne doit pas apparaitre en tant qu'instruction de premier niveau. 
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Semantique 

L'instanciation du modele de transformation de ('instruction xsi :comment ne doit pas 
creer autre cliose que des noeuds de type text ; sinon c'est une erreur. C'est aussi une 
erreur que ces noeuds textes contiennent des sequences de caracteres interdites dans un 
commentaireXM L (comme par exemple la sequence "--"). 

II est bien sflr impossible de creer un commentaire dans le document resultat autrement 
que par instruction xsi:comment ; la presence d'un commentaire dans un element 
source litteral est notamment sans effet sur le resultat, puisqu'un tel commentaire est 
ignore par le processeur X SLT. 



Exemple 

Une utilisation interessante des commentaires XML generes par un programme XSLT 
est de tracer I'activation des regies du programme lorsqu'il y a un probleme, pour en 
comprendre I'origine. Pour voir ce que eel a donne, nous reprenons le programme vu a la 
section Exemple, page 170, en pla^ant une instruction xsi :comment dans chaque regie : 

Concert.xsl 

<?xml version="1.0" encocling="UTF-16"?> 

<xsl rstylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method^'html ' encoding='IS0-8859-r /> 

<xsl :strip-space elements='Compositeurs'/> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl :value-of select="/Concert/Entete"/></title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl itempl ate> 

<xsl :template match="Entete"> 
<xsl :comment> 

<xsl :text>dans Entete : </xsl :text><xsl :value-of select="."/> 
</xsl :cominent> 

<p> <xsl :val ue-of select="."/> presentent </p> 
</xsl itempl ate> 

<xsl itemplate match="Date"> 
<xsl :comment> 

<xsl :text>dans Date : </xsl itextXxsl :value-of select="."/> 
</xsl :comment> 

<H1 align="center"> Concert du <xsl :val ue-of select="."/> </Hl> 



Les instructions de creation 

Chapitre 6 



</xsl :templ ate> 

<xsl itempl ate match="Lieu"> 
<xsl :cominent> 

<xsl :text>dans Lieu : </xsl itextXxsl :val ue-of select="."/> 
</xsl :coinment> 

<H4 al ign="center"> <xsl :value-of select="."/> </H4> 
</xsl :templ ate> 

<xsl itemplate match="Ensemble"> 
<xsl :cominent> 

<xsl :text>dans Ensemble : </xsl itextXxsl :val ue-of select="."/> 
</xsl :coinnient> 

<H2 al ign="center"> Ensemble <xsl :val ue-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<xsl itemplate match="Compositeurs"> 
<xsl :comment> 

<xsl :text>dans Compositeurs : </xsl itextXxsl :val ue-of select="."/> 
</xsl :comment> 

<H3 al1gn="center"> Oeuvres de <br/> <xsl :apply-templates/> </H3> 
</xsl :template> 

<xsl itempl ate match="Compositeur"> 
<xsl :comment> 

<xsl :text>dans Compositeur : </xsl itextXxsl :value-of select="."/> 
</xsl :comment> 

<xsl :value-of select="."/> 

<xsl:if test="not(position( ) = last())">, </xs1:if> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 

Leresultatobtenu estcelui-ci : 

Concert .html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d'Anacréon </title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<!--dans Entete : Les Concerts d'Anacreon --> 

<p> Les Concerts d'Anacr&eacuteion présentent </p> 

<!--dans Date : Jeudi 17 Janvier 2002, 20H30--> 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 

<!--dans Lieu : Chapelle des Llrsules--> 
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<H4 align="center">Chapelle des Ursules</H4> 
<!--dans Ensemble : "A deux violes esgales" --> 

<H2 al ign="center"> Ensemble «A deux violes esgales» </H2> 
<!--dans Compositeurs : M. MaraisD. CastelloF. Rognoni--> 
<H3 al ign="center"> Oeuvres de <br> 

<!--dans Compositeur : M. Marais-->M. Marais, 
<!--dans Compositeur : D. Castel 1 o-->D. Castello. 
<!--dans Compositeur : F. Rognoni-->F. Rognoni 
</H3> 
</body> 
</html> 

Instruction xshprocessing-instruction 

Syntaxe 

instruction xsi :processing-instruction permet de creer une processing-instruction 
XML dans I e document resultat, 

xsi :process1ng-instruction 

<xsl iprocessing-instruction name=". . ."> 
<!-- modele de transformation --> 

<!-- fin du modele de transformation --> 
</xsl :processing-instruction> 

L'instruction xsi :processing-instruction ne dolt pas apparaitre en tant qu' instruct! on 
de premier niveau. 

Semantique 

L'instanciation du modele de transformation de instruction xsi :processing-instruc- 
tion ne doit pas creer autre cliose que des noeuds de type text ; sinon c'est une erreur, 
C'est aussi une erreur que ces noeuds textes contiennent des sequences de caracteres 
interdites dans une processing-instruction XML (comme par exemple la sequence 
"?>■■), 

Les processing-instructions ne sont pas tres utilisees en X M L, aussi n'est-il pas facile de 
donner un exemple facilement testable. La processing-instruction la plus courante 
restecellequi s'adressea un navigateur pour lui indiquer lafeuilledestylea utiliser pour 
afficher le fichier XML refU. 

Une autre utilisation, plus originale, et qui peut donner des idees, est celle qui en faite 
dans X M etal (www.softquad.com/), un editeur de fichiers sources XML. Ayant declare une 
DTD pour I e fichier a editer, X M etal propose defagon contextuelle une palette de ballses 
possibles a inserer la oil se trouve place le curseur. Avec une DTD comme celle de doc- 
book, par exemple, on peut vouloir inserer a tel endroit un nouveau <para>, qui est I'ele- 
ment representant un paragraphe. 
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Note 

Docbook (http://docbook.org/) estune DTD associee ades feuilles de style XSLT pourredigerdes articles, des 
livres, et plus generalement de la documentation. Les feuilles de style XSLT produisent du HTML ou du FO 
(lequel donne du PS ou du PDF avec des processeurs FO adequats). 

X M etal reagit alors en creant non pas un element <para> vide, comme ceci : 

I <para></para> 

mais en creant un element contenant une processing-instruction : 

I <para><?xin-repl ace-text {para)?></para> 

L a difference est qu'un element vi de apparait comme tout autre element, alors qu'un ele- 
ment contenant la processing-instruction <?xm-repl ace-text {para}?> apparait 

avec letexte {para} en blanc surfond noir, cequi lerend particulierement visible. 

Rien n'empecherait done d'imaginer la production, par une feuille de style XSLT, d'un 
fichier XM L qui serait incomplet, mais a completer a la main sous XM etal, les zones a 
remplir etant mises en evidence par des balises <?xm-repi ace-text {para}?>. 

L'instruction X SLT pour generer une telle balise serait la suivante : 

L <xsl :processing-instruction name="xm-replace-text"> 
I <xsl:text> {paraX/xsl :text> 
' </xsl :processing-instruction> 

Instruction xshnumber 

L'instruction xsi :number est une instruction dont I'instanciation produit un numero. En 
ce sens, c'est une instruction de creation, puisqu'on peut supposer que ce numero 
n'existe pas en tant que tel dans la source XM L. M ais c'est vrai aussi que s'il n'y a pas 
de source XM L, il n'y a rien a numeroter ; et s'il n'y a rien a numeroter, il n'y a pas de 
numero, On peut done contester ajustetitrequexsi : number soit une instruction de crea- 
tion a proprement parler. 

Bande-annonce 

Concert.xtnl 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<maisons> 

<iiiaison id="l"> 
<RDC> 

<cuisine surface='12in2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 
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Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface^' 15m2'> 
Bibliotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palinier en zinc figurant le desert. </terrasse> 
<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<a1cove surface='8m2' fenetre='r> 
Lambri s . 

</al cove> 
</chainbre> 

<chanibre surface='18m2'> 

Lambri s . 
</chambre> 

<salleDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="2"> 
<RDC> 

<cuisine surface='12m2'> 

en ruine. 
</cuisine> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

vue sur la men 
</terrasse> 

<salleDeBains surface='15m2'> 

Douche. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="3"> 
<RDC> 

<sejour surface='40m2'> 
paillasson a 1 'entree 

</sejour> 
</RDC> 
<etage> 

<chambre surface='18m2'> 
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porte cochere. 
</chanibre> 
</etage> 
</niaison> 
</maisons> 

Concert. xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method^'xml ' encodings' ISO-8859-r indent^'yes' /> 

<xsl itempl ate match="*"> 

<xsl :el ement name=" {local -nameC . ) } "> 
<xsl :attribute nanie="numero"> 

<xsl:number count="*" level="multiple"/> 
</xsl :attribute> 
<xsl :apply-templates/> 
</xsl :element> 
</xsl :templ ate> 



<xsl itempl ate match="text( )"/> 



</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison numerD="l.l"> 
<RDC nLimero="l.l.l"> 

<cuisine nLimero="l . 1 . 1 . l"/> 
<WC numero="1.1.1.2"/> 
<sejour numero="1.1.1.3"/> 
<bureau numero="l . 1 . 1 .4"/> 
<garage numero="1.1.1.5"/> 
</RDC> 

<etage numero="1.1.2"> 

<terrasse numerD="1.1.2.1"/> 
<chambre nLimero="1.1.2.2"> 

<alcove numero="1.1.2.2.r7> 
</chambre> 

<chambre numero="1.1.2.3"/> 
<salleDeBains numero="1.1.2.4"/> 
</etage> 
</maison> 

<maison numero="l . 2"> 

<RDC numero="1.2.1"> 

<cuisine numero="1.2.1.1"/> 
<garage numero="1.2.1.2"/> 

</RDC> 
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<etage numero="1.2.2"> 

<terrasse nuinero="1.2.2.r7> 

<salleDeBains nuniero="1.2.2.2"/> 
</etage> 
</mai son> 

<maison numero^'l .3"> 
<RDC numero="1.3.1"> 

<sejour numero="1.3.1.r7> 
</RDC> 

<etage numero="1.3.2"> 

<chainbre nuinero="1.3.2.1"/> 
</etage> 
</mai son> 
</inaisons> 

Variante 

<xsl:number count="*" 1 evel ="any"/> 
Resultat 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<itiaisons numero="l"> 
<maison nuinero="2"> 
<RDC numero="3"> 

<cuisine numero="4"/> 
<WC numero="5"/> 
<sejour numero="6"/> 
<bureau numero="7"/> 
<garage numero="8"/> 
</RDC> 

<etage numero="9"> 

<terrasse numero="10"/> 
<chambre numero="H"> 

<alc5ve numero="12"/> 
</chambre> 

<chambre numero="13"/> 
<salleDeBains nuinero="14"/> 
</etage> 
</mai son> 

<maison nuinero="15"> 
<RDC numero="16"> 

<cuisine nuinero="17"/> 

<garage numero="18"/> 
</RDC> 

<etage numero="19"> 

<terrasse nuinero="20"/> 

<salleDeBains nuinero="2r7> 
</etage> 
</mai son> 

<maison nuinero="22"> 
<RDC numero="23"> 
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<sejour numero="24"/> 
</RDC> 

<etage numero="25"> 

<chanibre nuinero="26"/> 
</etage> 
</inaison> 
</niaisons> 

Van" ante 

' <xsl:number count="*" level="single"/> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison nuniero="l"> 
<RDC numero="l"> 

<cuisine nuinero="r7> 
<WC nuniero="2"/> 
<sejour numero="3"/> 
<bureaLi numero="4"/> 
<garage numero="5"/> 
</RDC> 

<etage nuinero="2"> 

<terrasse numero="l"/> 
<chambre nuinero="2"> 

<alcove numero="r7> 
</chambre> 

<chambre nuinero="3"/> 
<salleDeBains numero="4"/> 
</etage> 
</maison> 

<maison nuniero="2"> 
<RDC nuniero="l"> 

<cuisine nuinero="r7> 

<garage nuinero="2'7> 
</RDC> 

<etage numero="2"> 

<terrasse numero="r7> 
<salleDeBains numero="2"/> 

</etage> 
</inaison> 

<maison nLiniero="3"> 
<RDC nurtiero="l"> 

<sejour numero="r7> 
</RDC> 

<etage numero="2"> 

<chambre nuinero="r7> 
</etage> 
</inaison> 
</maisons> 



Instruction xshnumber 

Chapitre 6 

Syntaxe 

xsl :number 



<xsl inumber 








1 evel =" . 




<!-- 


'single' (par defaut), 'any' ou 'multiple' 


counts" . 




<!-- 


motif XPath --> 


froin= ". 




<!-- 


motif XPath --> 


val ue=" . 




<!-- 


expression XPath --> 


forniat=" 




<!-- 


{}une chaine de caracteres --> 


1 ang=" . . 




<!-- 


Ocode langue (en, fr, etc.) --> 


1 etter-Vc 


il ue=" . . . " 


<!-- 


{} 'alphabetic' ou 'traditional' --> 


grouping 


-separator=" . 


." <!-- 


{}un caractere --> 


grouping 


-size=" ..." 


<!-- 


{}un entier --> 



/> 



Tous ces attributs sont facultatifs. 

Les accolatJes in(Jiquent les attributs pour lesquels un (jescripteur 6e valeur (jifferee est 
autorise, 

L'instruction xsi : number est toujours vi(je. 

instruction xsi :number ne(Joit pas apparaitre en tant qu'instruction tie premier niveau. 
Semantique 

L'instanciation (Je instruction xsi :number a 6eux effets in(jepen(Jants : 

• Le premier est (jecalculer un numero &or6re pour le noeu(J courant. 
Dans ce cas, I'attribut vai ue (jolt etre absent . 

• Le (Jeuxieme est tie formater un numero, afin 6e lui (Jonner un aspect 6e numero : 1, 
3.5,A.l, (iii),VI,etc. 

L'attribut value peut etre absent ; (Jans ce cas le numero formate est le numero d'ordre 
calcule. 

L'attribut value peut etre present ; (jans cecas le numero formate est la valeur fournie 
par I 'expression XPath, (jontlecalcul (joitamener une valeur qui puisseetreconvertie 
en entier. 

L'instruction xsi : number permet 6e compter tOUteS SOrteS 6e noeU(Js (element, comment, 

text, attribute,,,), mais (Jans la pratique il bien rare (j'avoir a compter autre chose que 
(jes elements. 

Calcul d'un numero d'ordre 

Prenons par exemple la sequence {X a R ? p p a}. Quel est le numero 6u (jernier element 
6e cette sequence ? Tout 66per\6 6e ce que I'on compte : si I'on compte les lettres, il est 
egal a 6 ; si I'on compte les 'a', il vaut 2 ; si I'on compte tout, il vaut 7, 

L'attribut count permet 6e (determiner la nature 6es noeu(ds qui seront comptes, et (jonc le 
numero qui sera affecte au noeud courant. 
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En Tabsenced'attribut count, cesontlessemblablesdu noeud courantqui sontcomptes. 
Par example, si le noeud courant est un noeud de type text, on compte les text ; si le 
noeud courant est un element <truc>, on compte les <truc>. 

Si I'attribut count est present, sa valeur est un motif X Path ; pour calculer le numero du 
noeud courant, le processeur XSLT compte le nombre de noeuds situes avant lui, et qui 
concordent avec ce motif. II est vrai que «situes avant » est une formulation assez 
vague ; la definition precise depend de la valeur de I'attribut level (d'une maniere assez 
complexe), et on pourra la consulter (par curiosite) dans le standard XSLT. Neanmoins, 
cette definition precise est plus utilie a un programmeur realisant un processeur XSLT 
qu'a un programmeur real isant une feui I le de style X SLT. L e programmeur X SLT peut se 
contenter de comprendre les trois styles de numerotation sur un exemple, sans avoir a 
connaitre I'algorithme exact du calcul des numeros ; nous verrons un peu plus loin (voir 
Differents modes de calcul d'un numero d'ordre, page 352) un tel exemple. 

Attention 

Un pointassez important estque le decompte se faittoujours sur un document source XML, c'est-a-dire, en prin- 
cipe, sur le document source XML. II est done possible de lancer le decompte sur un autre document que le 
document source principal, acondition que ce soitun document source, c'est-a-dire un documentobtenu paria 
fonction standard document o, ou par la reference a une variable contenantunTST (Temporary Source Tree). 
En consequence, il est impossible de decompter directement des elements du document resultat, mais cela 
reste possible indirectement II feutd'abord construire, dans une premiere passe, le resultat ou une partie du 
resultat en tantqueTST lie a une variable. Dans une deuxieme passe, on instancie des <xsi :number> qui vont 
done porter sur les elements de ce TST (arbre d'un document source), ce qui aura pour effet de produire des 
numerotations relatives a I'ordre des elements tels qu'ils apparaitrontdans le document resultat, etnon tel qu'ils 
apparaissentdans le documentsource. Nous en verrons plus loin un exemple (voir Exemple, page 363). 

Exemple 

Reprenons I'exemple vu a la section Copie d'un nceud de type attribute, page 335 ; il 
s'agissait d'illustrer la recopie d'attributs en partant de la source XM L suivante : 

plagesCD.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<pl ages> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2="oded" org="fech"> 

Grave 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="finrt" 
vl2=''oded'' vlc="dsmp''> 
Presto / Prestissimo 
</pl age> 

<plage vdg^'cplu" clv="nspt" thb="eblq" vll="finrt" 
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vl2="odecl"> 

Adagio 
</pl age> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</pl age> 
</pl ages> 

Le programme X SLT realisant la copie auquel nous etions arrives est celui-ci : 
copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl istylesheet 

xmlns :xsl = "http: //www. w3.org/1999/XSL/Transform" 
version="l .0"> 

<xsl:output inethod='xnir indent="yes" encodings' ISO-8859-r /> 

<xsl : tempi ate match="/"> 
<pl ages> 

<xsl :apply-templates/> 
</pl ages> 
</xsl :templ ate> 

<xsl :template match="pl age"> 
<xsl :copy> 

<xsl lapply-templates select="attribute: :*"/> 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Voyons maintenant comment modifier la copie pour ajouter un attribut indiquant le 
numero de plage. C'est extremement simple a faire : 11 suffit de compter les <piage>, et 
pour chacune, de creer un nouvel attribut contenant la valeur du compteur : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 
version="l .0"> 



<xsl:output method='xmr indent="yes" encodings' ISO-8859-r /> 
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<xsl itempl ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</pl ages> 
</xsl itempl ate> 

<xsl itempl ate match="pl age"> 

<xsl :variable naine="numero"><xsl mumber/X/xsl :variable> 
<plage No=" {Snumero) "> 

<xsl lapply-templates select="attribute: :*"/> 
<xsl : val ue-of select="."/> 
</pl age> 
</xsl :templ ate> 

<xsl itempl ate match=" attribute: :*"> 

<xsl :copy/> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<plages> 

<plage No="l" vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 

vl 2="ocled" org="fech">Grave</pl age> 
<plage No="2" thb="eblq" vdg="cplu" clv="nspt" vll="fmrt" 

vl2="oded" vcl ="dsmp">Presto / Prestissimo</plage> 
<plage No="3" vdg="cplu" clv="nspt" thb="eblq" vll="fnirt" 

vl 2="oded">Adagio</pl age> 
<plage No="4" thb="eblq" vdg="cplu" clv="nspt" vll="fnirt" 

vl2="oded" vcl="dsmp" org="fech">Presto Recit de basse</pl age> 

</pl ages> 

Ici, I'instruction xsi inumber setrouvedansun modelede transformation ou lenoeud cou- 
rant est necessairement une <pi age>, et comme on veut justement compter les <pi age>, il 
n'y a pas besoin defournir I'attribut count. 

Differents modes de calcul d'un numero d'ordre 

U ne fois qu'on a determine ce qu'on voulait compter, il y a plusieurs fagons de compter : 
on peut compter sequentiellement (comme dans le cas de plages, ci-dessus), ou on peut 
compter en faisant transparaitre la nature arborescente du document XM L, C 'est I'attri- 
but level qui intervient ici. 

L e pi us si mpl e est de montrer un document arborescent, et de voi r les di fferentes possi bi - 
lites de numerotation de ses elements. 

Nous allons done partir du document suivant, representant un texte structure en sections, 
so us- sections, paragraphes, notes de bas de page et listings de programmes : 
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canevasdoc.xtnl 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<article lang="fr"> 
<sectl> 

<titre>A</titre> 

<regl e importance="l">RlRlR</regle> 
<sect2> 

<titre>B</titre> 
<para>bbb</para> 
</sect2> 
<sect2> 

<titre>C</titre> 
<sect3> 

<titre>D</titre> 
<para>ddd 

<regle importance="3">R2R2R</regle> 
<note>Nt</note>ddd/ 
<note>Nv</note> 
</para> 
</sect3> 
<sect3> 

<titre>E</titre> 
<para>eee 

<note>Nah</note>eee: 
</para> 

<para>e,e,e</para> 

<regl e importance="l">R3R3R</regle> 

<programl isting>ay</programl isting> 

<para>e;e;e</para> 

<programl i sting>bg</programl i sting> 

<para>e!e!e 

<regle importance="2">R4R4R</regle> 
<note>Naa</note>(eee) 
<note>Nz2</note>[eee] 
<note>NEE</note>(e.e.e) 

</para> 
</sect3> 
<sect3> 

<titre>F</titre> 

<programl i sting>ck</programl i sting> 
</sect3> 
</sect2> 
</sectl> 
<sectl> 

<titre>G</titre> 
<sect2> 

<titre>H</titre> 
<para>hhh</para> 
<para>hhh/ 

<note>Nhx</note>hhh: 
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</para> 
</sect2> 
</sectl> 
</arti cl e> 

Voici maintenant le programme que nous allons utiliser pour numeroter ces divers ele- 
ments; hormis ^instruction xsi :number proprement dite, le reste du programme, sans 
etre d'un grand interet, est un peu complique, a cause de la mise en page indentee que 
I'on veut obtenir, mais qui n'est pas du tout typique des problemes que I 'on se pose 
d'ordinaireen XSLT : 

sequence.xsl 

1 <?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 



<xsl :templ ate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl |sect2 |sect3 |titre |para | 
note Iprogramlisting | regie" 
level="any"/>.<xsl :value-of select="name( )"/> 
<xsl:text> </xsl:text> 
<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl itempl ate match="para"> 

<xsl:number count="sectl |sect2 |sect3 [titre |para | 

note Iprogramlisting | regie" 1 evel ="any"/> 

<xsl :text>.</xsl :text> 

<xsl lapply-templates mode="inpara"/> 
</xsl :templ ate> 

<xsl itempl ate match="note" mode="inpara"> 

<xsl:number count="sectl |sect2 |sect3 |titre |para | 

note Iprogramlisting |regle" 1 evel ="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteNote=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="programl i sting "> 

<xsl:number count="sectl |sect2 |sect3 |titre |para | 

note Iprogramlisting |regle" 1 evel ="any"/> 
<xsl :text>.</xsl :text> 
<xsl :text>textePrograml isting=</xsl :text> 
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<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="titre"> 

<xsl:number count="sectl |sect2 |sect3 |titre |para | 

note Iprogramlisting | regie" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="regl e" mocle="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl itemplate match="regl e"> 

<xsl:number count="sectl |sect2 |sect3 |titre |para | 

note Iprogramlisting |regle" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl :template match="text( )" mode="1npara"> 
<xsl :if test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl itempl ate> 

</xsl :stylesheet> 

Resultat (1eve1=« any ») 

l.sectl 

2. texteTitre=A 

3. texteRegle=RlRlR 

4. sect2 

5. texteTitre=B 

6. textePara=bbb 

7.sect2 

8. texteTitre=C 

9. sects 

10. texteTitre=D 

11. textePara^ddd 
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12. texteRegle=R2R2R 

13. texteNote=Nt textePara^ddd/ 

14. texteNote=Nv 

15. sects 

16. texteTitre=E 

17. textePara=eee 

18.texteNote=Nah textePara=eee: 

19. textePara=e,e,e 

20. texteRegle=R3R3R 

21 . textePrograml i stingray 

22. textePara=e;e;e 

23. textePrograml isting^bg 

24. textePara=e!e!e 

25. texteRegle=R4R4R 

26. texteNote=Naa textePara=(eee) 

27 . texteNote=Nzz textePara=[eee] 

28. texteNote=NEE textePara=(e,e.e) 

29.sect3 

30. texteTitre=F 

31 . textePrograml i sting^ck 

32.sectl 

33. texteTitre=G 

34. sect2 

35. texteTitre=H 

36. textePara=hhh 

37. textePara=hhh/ 

38.texteNote=Nhx textePara=hhh ; 

Resultat (1eve1=« single ») 

l.sectl 

1 . texteTitre^A 

2. texteRegle=RlRlR 

3. sect2 

1. texteTitre=B 

2. textePara=bbb 

4. sect2 

1. texteTitre^C 

2. sect3 

1. texteTitre=D 

2. textePara=ddd 

1. texteRegle=R2R2R 

2. texteNote=Nt textePara^ddd/ 

3. texteNote=Nv 
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3. sects 

1. texteTitre^E 

2. textePara=eee 

l.texteNote^Nah textePara=eee; 

3. textePara=e,e,e 

4. texteRegle=R3R3R 
B.textePrograml isting=ay 

6. textePara=e;e;e 

7 . textePrograml isting=bg 

8. textePara=e!e!e 



1. texteRegle=R4R4R 

2. texteNote=Naa textePara^Ceee) 

3. texteNote=Nzz textePara=[eee] 

4. texteNote=NEE textePara=(e,e,e) 



2.sectl 

1. texteTitre^G 

2. sect2 

1 . texteTitre^H 

2. textePara=hhh 

3. textePara=hhh/ 



1.1. texteTitre=A 

1.2. texteRegle=RlRlR 

1.3. sect2 

1.3.1. texteTitre=B 

1.3.2. textePara=bbb 

1.4. sect2 

1.4.1. texteTitre=C 

1.4.2. sect3 

1.4.2.1. texteTitre=D 

1.4.2.2. textePara=ddd 

1.4.2.2.1. texteRegle=R2R2R 

1.4.2.2.2. texteNote=Nt textePara=ddd/ 

1.4.2.2.3. texteNote=Nv 

1.4.3. sect3 

1.4.3.1. texteTitre=E 

1.4.3.2. textePara=eee 
1.4.3.2.1.texteNote=Nah textePara=eee; 



4 



sect3 
1 .texteTitre^F 
2. textePrograml isting=ck 



l.texteNote^Nhx textePara^hhh; 



Resultat (1eve1=« multiple ») 



l.sectl 
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1.4.3.3. textePara=e,e,e 

1.4.3.4. texteRegle=R3R3R 

1 .4.3.5. texteProgramlisting=ay 

1.4.3.6. textePara=e;e:e 

1.4.3.7 . texteProg rami i sting=bg 

1.4.3.8. textePara=e!e!e 

1.4.3.8.1. texteRegle=R4R4R 

1.4.3.8.2. texteNote=Naa textePara=(eee) 

1.4.3.8.3. texteNote=Nzz textePara=[eee] 

1.4.3.8.4. texteNote=NEE textePara=(e,e,e) 

1.4.4. sect3 

1.4.4.1. texteTitre=F 

1.4.4.2. texteProgramlisting=cl< 

2.sectl 

2.1. texteTitre=G 

2.2. sect2 

2.2.1. texteTitre=H 

2.2.2. textePara=hhh 

2.2.3. textePara=hhh/ 
2.2.3.1.texteNote=Nhx textePara=hhh ; 

Exemple : numerotation classique pour un livre 

Nous reprenons le meme exemple, mais nous voulons avoir une numerotation classique 
pour un livre : numerotation hierarchiquepour les sections, leresten'etant pas numerote, 
sauf les notes de bas de pages qui ont une numerotation sequentielle non hierarchique. 

sequence.xsl 

, <?xml version="1.0" encoding="LITF-16"?> 
<xsl istylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itemplate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="mul tiple"/>.<xsl rvalue -of select="name( )"/> 

<xsl:text> </xsl:text> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :templ ate match="para"> 

<xsl :apply-templates niode="inpara"/> 
</xsl :templ ate> 

<xsl itemplate match="note" mode="inpara"> 
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<xsl:number count="note" level="any"/> 
<xsl :text>.</xsl :text> 
<xsl :text>texteNote=</xsl :text> 
<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl rtemplate match="programlisting"> 

<xsl :text>textePrograml isting=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl itempl ate match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl itemplate match="regl e" mode="inpara"> 

<xsl lapply-templates select="."/> 
</xsl itempl ate> 

<xsl itemplate match="regl e"> 

<xsl itext>texteRegl e=</xsl itext> 

<xsl ival ue-of select="."/> 

<xslitext> </xslitext> 
</xsl itempl ate> 

<xsl itempl ate match="text( )" mode="inpara"> 
<xsl I if test= "normal ize-space( . )"> 
<xsl itext>textePara=</xsl itext> 
</xsl iif> 

<xsl ival ue-of select="."/> 
<xslitext> </xslitext> 
</xsl itempl ate> 
</xsl istylesheet> 

N ous avons reduit la portee du decompte : I'attribut count ne mentionne plus que les ele- 
ments secti, sect2et sect3 ; deplus nous avons enleve I'instruction xsi mumber des ele- 
ments que nous ne voulons plus compter. Pour les notes de bas de page, nous avons utilise 
la valeur "any" de I'attribut i evei afin d'avoir une numerotation lineaire. Void le resultat : 



Resultat 

l.sectl 

texteTitre=A 

texteRegle=RlRlR 

l.l.sect2 

texteTitre=B 
textePara=bbb 
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1.2.sect2 

texteTitre^C 
1.2.1.sect3 

texteTitre^D 
textePara=ddd 

texteRegle=R2R2R 

1. texteNote=Nt textePara^ddd/ 

2. texteNote=Nv 



1.2. 2. sects 

texteTitre^E 
textePara=eee 

3.texteNote=Nah textePara^eee; 



textePara=e,e.e 
texteRegle=R3R3R 
texteProgramli stingray 
textePara=e;e:e 
textePrograml i sting^bg 
textePara=e!e!e 

texteRegle=R4R4R 

4. texteNote=Naa textePara=(eee) 

5. texteNote=Nzz textePara=[eee] 

6. texteNote=NEE textePara=(e,e,e) 



1.2. 3. sects 

texteTitre^F 
textePrograml isting^ck 



2.sectl 

texteTitre^G 
2.1.sect2 

texteTitre^H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara^hhh; 



Reinitialisation d'un numero d'ordre 

Un autre probleme est la reinitialisation du numero calcule. Par exemple, il peut arriver, 
pour un livre, que I'on veuille reinitialiser la numerotation des notes de bas de pages a 
chaque nouveau chapitre. 

C'est I'attribut from qui permet cela : sa valeur est un motif XPath, et a chaque fois que 
le noeud courant Concorde avec ce motif, la numerotation est reinitialisee. 

Exemple 

Nous reprenons le meme exemple, mais nous supposons que la numerotation des notes 
doitetre reinitialisee pour chaque sections : 
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sequence.xsl 

<?xnil version="1.0" encocling="UTF-16"?> 
<xsl rstylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l .0"> 

<xsl:output method^'text' encoding=' ISO-8859-r /> 

<xsl : tempi ate niatch="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="multiple"/>.<xsl :value-of sel ect="name( ) "/> 

<xsl:text> </xsl:text> 

<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl :templ ate match="para"> 

<xs1 :apply-templates mode="inpara"/> 
</xsl rtempl ate> 

<xsl :template match="note" mode="inpara"> 

<xsl:number count="note" from="sect3" 1 eve! ="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteNote=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl :template match="programlisting"> 

<xsl :text>textePrograinl isting=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl itemplate match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl itemplate match="regl e" mode="inpara"> 

<xsl lapply-templates select="."/> 
</xsl itempl ate> 

<xsl itempl ate match="regl e"> 

<xsl itext>texteRegl e=</xsl itext> 

<xsl ivalue-of select="."/> 

<xslitext> </xslitext> 
</xsl itempl ate> 

<xsl itemplate match="text( )" mode="inpara"> 
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<xsl :if test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 
</xsl :stylesheet> 

Resultat (froni=« sect3 » pour les notes) 

1. sectl 

texteTitre^A 
texteRegle^RlRlR 

1.1. sect2 
texteTitre^B 
textePara=bbb 

1.2. sect2 
texteTitre^C 

1.2.1. sects 
texteTitre^D 
textePara=ddd 

texteRegle=R2R2R 

1. texteNote=Nt textePara^ddd/ 

2. texteNote=Nv 

1.2. 2. sects 
texteTitre^E 
textePara=eee 

1. texteNote=Nah textePara^eee; 

textePara=e,e.e 
texteRegle=R3R3R 
textePrograml i sti ng=ay 
textePara=e;e:e 
textePrograml isting^bg 
textePara=e!e!e 

texteRegle=R4R4R 

2. texteNote=Naa textePara=(eee) 

3. texteNote=Nzz textePara=[eee] 

4. texteNote=NEE textePara=(e,e.e) 

1.2. 3. sects 
texteTitre^F 
textePrograml isting^ck 

2. sectl 

texteTitre=G 
2.1.sect2 

texteTitre^H 

textePara=hhh 
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cTiapitrF6^H 

ItextePara^hhh/ 
l.texteNote^Nhx textePara^hhh; 

Numero d'ordre sans decompte 

L'attribut vaiue="...", lorsqu'il est present, permet de fournir soi-meme la valeur du 
numero a instancier. Cela peut notamment servir lorsque I'ordre des elements dans le 
document resultat n'est pas le meme que dans la source X M L . Dans ce cas on peut consti- 
tuerun node-set, puis uti User la fonction posuiono pour renseigner l'attribut value, 

Exemple 

Nous reprenons le meme exemple, mais nous supposons maintenant que nous voulons 
indiquer un recapitulatif des regies importantes a la fin du document. On peut faire cela 
tres facilement : 

sequence.xsl 

<?xml version="1.0" encocling="UTF-16"?> 
<xsl istylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l .0"> 

<xsl:output method='text' encoding=' ISO-8859-r /> 



<xsl : tempi ate match="/"> 
<xsl :apply-teinplates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl lapply-templates sel ect="//regl e" mocle="recap"/> 
</xsl itempl ate> 

<!-- etc. --> 

<xsl :template match="regl e" mode="inpara"> 

<xsl lapply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regl e"> 

<xs1 :text>texteRegl e=</xsl :text> 

<xsl :val ue-of select="."/> 

<xsl:text> </xsl:text> 
</xsl itempl ate> 

<xsl itemplate match="regl e" mode="recap"> 

<xsl:number value="position()"/>. <xsl :value-of select="."/> 

<xsl :text> 
</xsl :text> 

</xsl :templ ate> 
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<xsl rtempl ate match="text( ) " niode="inpara"> 
<xsl :if test=" normal ize-space( . ) "> 
<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre^G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara^hhh; 

Regies importantes : 

1. RIRIR 

2. R2R2R 

3. R3R3R 

4. R4R4R 

La ou on voulait en venir, c'est qu'on aimerait de plus que ces regies soient classees par 
ordre d'importance (attribut importance de I'element <regie>). Du coup, on est dans un 
cas ou I'ordre de ces regies dans le resultat est different de I 'ordre de ces memes regies 
dans le document source. 

On est alors oblige de proceder autrement : une solution (mais ce n'est pas la seule : voir 
Numero d 'ordre dans un document source secondaire, page 367) est de constituer un 
node-set contenant les regies triees dans le bon ordre, et fournir nous-memes la numero- 
tation a I 'instruction xsi : number grace a I 'attribut vaiue=" ..." : 

sequence.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl rstylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl :templ ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regl es importantes : 
</xsl :text> 

<xsl :for-each select="//regle"> 
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<xsl :sort sel ect="@importance"/> 

<xsl:number value="position()"/>. <xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl : tempi ate match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="multiple"/>.<xsl :value-of sel ect="name( ) "/> 

<xsl :apply-teinplates/> 
</xsl :templ ate> 

<!-- etc. --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Regies importantes : 

1. RIRIR 

2. R3R3R 

3. R4R4R 

4. R2R2R 

Mais peut-etre penserez-vous qu'il n'etait pas necessaire de passer par ('instruction 
xsi :number pour obtenir ce resultat. C'est vrai que la numerotation est fournie par la 
valeurrenvoyeeparlafonction posuiono : alors pourquoi ne pas exploiter cettevaleur 
directement dans une instruction xsi :vai ue-of ? 

<?xnil version="1.0" encocling="UTF-16"?> 
<xsl rstylesheet 

xmlns : xsi ="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl :template match="/"> 
<xsl :apply-teinplates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl :for-each sel ect="//regl e"> 
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<xsl :sort select="@importance"/> 

<xsl :value-of select="position()"/>. <xsl :value-of select="."/> 
<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<!-- etc. --> 

</xsl :stylesheet> 

De fait, ceci fonctionne aussi bien, M ais, en anticipant sur une procliaine section (voir 
Rendu de la numerotation, page 368), on peut tres facilement modifier le rendu de la 
numerotation avec xsi : number, alors qu'avec xsi :vaiue-of, il faut tout programmer a 
la main : 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itempl ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regl es importantes : 
</xsl :text> 

<xsl :for-each select="//regle"> 

<xsl :sort select="@iinportance"/> 

<xsl:number val ue="position( )" format="r7>. <xsl :val ue-of 

sel ect=" . "/> 

<xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<!-- etc. --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre^G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara^hhh; 
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Regies importantes : 

I. RIRIR 

II. R3R3R 

III. R4R4R 

IV. R2R2R 

Numero d'ordre dans un document source secondaire 

Une derniere solution (pour le probleme de la section precedente) consisterait a utiliser 
un TST intermedial re. En effet, on veut numeroter des regies dans I'ordre ou elles appa- 
raissent dans ie document resuitat. M ais on sait qu'ii est impossible de numeroter direc- 
tement des elements qui se trouvent ailleurs que dans un document source. II faut done 
commencer, dans une premiere passe, par constituer un document source secondaire 
(un TST, voir Temporary Source Tree, page 192). Dans ce TST, on place les elements 
a numeroter, dans le bon ordre (celui du resultat vise), en utilisant eventuellement 
<xsi:sort>. Dans une deuxieme passe, le TST etant constitue, on s'en sert comme 
sourceXM L secondaire ; des lors une instruction <xsi :nLimber> va porter sur cette source 
X M L, et le decompte se fera par rapport a cette source. 

Example 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l.l"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output inethod='text' encoding=' ISO-8859-r /> 



<xsl : tempi ate match="/"> 
<xsl :apply-teinplates/> 
<xsl :text>Regles importantes : 
</xsl :text> 

<xsl ivariable name="l esRegl es"> 

<xsl :for-each sel ect="//regl e"> 

<xsl isort sel ect="@importance"/> 
<xsl:copy-of select="."/> 

</xsl :for-each> 

</xsl :variable> 

<xsl :for-each select="$lesRegles//regle"> 

<xsl :number/>. <xsl :val ue-of select="."/><xsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl itempl ate> 



<xsl :template match="sectl | sect2 |sect3"> 
<xsl:number count="sectl | sect2 |sect3" 
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level="mul tiple"/>.<xsl :value-of select="name( )"/> 
<xsl :apply-teniplates/> 
</xsl itempl ate> 

<!-- etc. comme avant --> 

</xsl :stylesheet> 

Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre^H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara^hhh; 

Regies importantes : 

1. RIRIR 

2. R3R3R 

3. R4R4R 

4. R2R2R 

Peut-etre vous demandez vous si I'on pouvait faire I'economie de la deuxieme passe, 
c'est-a-dire du deuxieme <xsi :for-each>, en pla^ant directement instruction 
<xsi :number> dans le premier <xsi :for-each>. La reponse est non, car le decompte se 
fait dans le document source courant, pas dans la liste de noeuds temporaire constituee 
par <xsi :for-each> et reordonnee par <xsi :sort>. 

Le modele de transformation du deuxieme <xsi :for-each> est relatif a un document 
source secondai re, reference par la variable lesRegies. Les expressions X Path ou les ins- 
tructions XSLT qui s'y trouvents'appliquentdonc aceTST, etnon au document source 
principal. Les deux passes sontdonc necessaires. 

Rendu de la numerotation 

Un numero de sequence etant calcule ou simplement fourni, on s'interesse maintenant a 
I'aspect exterieur sous lequel il est instancie dans le document resultat. Par exemple un 
numero dont la valeur est 4 peut apparaitre sous les formes equivalentes 4, d, D, 004, IV, 
iv, (iv), 4°, IV-, etc. Toutes ces formes sont instanciables directement par instruction 
xsi :number, sansqu'il y ait besoin de programmer quoi quecesoit. Cela s'applique bien 
sur au cas plus complique ou le numero est forme de plusieurs nombres, dans le cas 
d'une numerotation hierarchique (ievei="rtmitipie") : 1.2.1 pourrait etre rendu A.2-a, 
par exemple. 

Le principe est le suivant : on ecrit une chaine de formatage, a peu pres dans le meme 
esprit que cequ'on pourrait faire en C-i-i-ou en C avec instruction printf. Cettechaine 
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contient deux types d'informations qui doivent alterner dans un ordre quelconque : la 
ponctuation (i.e. les signes divers tels que ". .•)-('etc.) et les caracteres alplianume- 
riques. Ces derniers sont interpretes comme des descripteurs de formats de sortie, alors 
que les signes de ponctuation sont pris pour ce qu'ils sont sans interpretation particuliere. 

interpretation des descripteurs de format se fait sur la base des conventions suivantes : 

• 1 : pour instancier un numero defagon banale ; 

• 001 : pour instancier un numero en imposant un nombre minimum de chiffres ; 

• a : pour instancier un numero sous forme de sequence de lettres (a b c ... z aa ab ac ... 
az ... ba ...) ; 

• A : meme chose avec des lettres majuscules ; 

• i : pour instancier un numero en chiffres romains minuscules ; 

• I : pour instancier un numero en chiffres romains majuscules. 
Exemples : 

Numero hierarchique 

valeur: 2 4 2 5 

format: A I-l.a 
rendu : B IV-2.e 

format: 001 a.i .1 
rendu : 002 d.ii .5 

Ici, il y a beaucoup de possibilites et de variantes, notamment en utilisant les attributs 

grouping-separator, grouping-size, iang, et letter-value. On pourra Se reporter au 

Standard XSLT 1.0 pour une description de leurs effets respectifs. 
Exemple 

Nous allons reprendre le programme XSLT precedent, et I'adapter pour sortir une nume- 
rotation classique des sections : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 



<xsl :template match="/"> 
<xsl :apply-teinplates/> 
<xsl :text>Regles importantes : 
</xsl :text> 
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<xsl :for-each select="//regle"> 

<xsl :sort select="@iinportance"/> 
<xsl:number val ue="position( )" format='r/> 
<xsl:text> </xsl:text> 
<xsl :value-of select=" . "/Xxsl :text> 

</xsl :text> 

</xsl :for-each> 
</xsl :templ ate> 

<xsl itempl ate match="sectl | sect2 |sect3"> 
<xsl:number count="sectl | sect2 |sect3" 

level="multiple" forinat="I-l.a "/> 
<xsl :val ue-of select="name()"/> 
<xsl :apply-teniplates/> 

</xsl :templ ate> 

<xsl itempl ate match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :templ ate> 

<xsl itemplate match="note" mode="inpara"> 

<xsl:number count="note" level ="any" fonnat="l . "/> 

<xsl :text>texteNote=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl itemplate match="programlisting"> 

<xsl :text>textePrograml isting=</xsl :text> 
<xsl :value-of select="."/> 
<xsl:text> </xsl:text> 

</xsl :templ ate> 

<xsl itempl ate match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl :value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xs1 :templ ate match="regle" inode="inpara"> 

<xsl lapply-templates select="."/> 
</xsl itempl ate> 

<xsl itempl ate match="regle"> 

<xsl itext>texteRegl e=</xsl itext> 

<xsl ivalue-of select="."/> 

<xslitext> </xslitext> 
</xs1 itempl ate> 

<xsl itempl ate match="text( ) " mode="inpara"> 
<xsl lif test=" normal ize-space( . ) "> 
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<xsl :text>textePara=</xsl :text> 
</xsl :if> 

<xsl :val ue-of select="."/> 
<xsl:text> </xsl:text> 
</xsl itempl ate> 

</xsl :stylesheet> 

Resultat 

I sectl 
texteTitre=A 
texteRegle=RlRlR 
I-l sectZ 

texteTitre=B 
textePara=bbb 

I- 2 sect2 
texteTitre=C 
1-2. a sects 

texteTitre=D 
textePara=cldd 

texteRegle=R2R2R 

1. texteNote^Nt textePara=dcld/ 

2. texteNote=Nv 

1-2. b sects 

texteTitre=E 
textePara=eee 

3. texteNote=Nah textePara=eee; 

textePara=e,e,e 
texteRegle=R3R3R 
textePrograml i stingray 
textePara=e;e;e 
textePrograml i sting=bg 
textePara=e!e!e 

texteRegle=R4R4R 

4. texteNote=Naa textePara=Ceee) 

5. texteNote=Nzz textePara=[eee] 

6. texteNote=NEE textePara=(e.e,e) 

1-2. c sects 

texteTitre=F 
textePrograml i sting^ck 

II sectl 
texteTitre=G 

II- l sect2 
texteTitre=H 
textePara=hhh 
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textePara=hhh/ 

7.texteNote=Nhx textePara^hhh; 

Regies importantes : 

I RIRIR 

II R3R3R 

III R4R4R 

IV R2R2R 

II fautnoter que le format etantfourni en tant qu'attribut, les regies generales lexicogra- 
phiques pour un attribut XML s'appliquent : certains caracteres comme "<■■ ou "&" sont 
interdits, et les espaces blancs sont normalises. Ici, en admettant que I'on veuille une 
tabulation apresleschiffresromainsdela numerotation des regies, 11 neserviraitarien de 
placer cette tabulation en tant que signedeponctuation dans I e format, car elleserait nor- 
malisee en espace ordinaire. Cela implique done de placer cette tabulation a I'exterieur, 
dans une instruction xsi :text. 
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Decoupage d'une application 

XSLT 



Ce chapitre decrit les outils disponibles en XSLT pour decouper une application en 
plusieurs morceaux, soit pour des raisons de maintenabilite, soit pour des raisons de 
reutilisabilite. A noterquelegrain desemantiqueXSLT estia regleou lemodelenomme ; 
la reutilisation consiste done a constituer des bibliotheques de regies ou de modeies nom- 
mes, ce qui n'est pas tres different, dans ie principe, de ia constitution de bibiiotlieques 
de sous-programmes dans des iangages commeC, Pascai, Coboi, Fortran, etc. 

M ais 5a, c'est du genie iogiciei qui fleure bon ies annees soixante (du xx^ siecie), et on 
sait que ie resuitat n'a pas ete a ia liauteur des esperances, et que ia notion de bibiio- 
tiieque de fonctions reutiiisabies ne marciie que dans des cas tres precis, notamment ceux 
Ou ies structures de donnees manipuiees par ces fonctions sont reguiieres et trivial es (par 
exempie, une bibiiotiiequede fonctions matiiematiquesou grapiiiques, qui n'utiiisentque 
des tableaux). 

Des que les structures manipuiees sont complexes et diversifiees, la notion de biblio- 
theque de fonctions atteint ses limites, et c'est la que la notion d'objets et de classes 
prend Ie relais, en permettant de constituer des bibliotlieques de classes, qui sont des 
grains semantiques beaucoup plus gros que des fonctions, capables d'encapsuler ces 
fameuses structures de donnees. 

Est-ce a dire que les bibliotlieques de regies et de modeies nommes reutiiisabies sont 
voues a i'eciiec, tout comme les bibliotlieques de fonctions ? 

Non, car on observera que justement, en XSLT, 11 n'y a aucune diversite possible en 
matiere de structure de donnees. On peut meme dire qu'a part Ie TST attache a une va- 
riable, 11 n'y a rien. XSLT est fait pour manipuler desarbresXM L, pas pour modeliser Ie 
processus metier d'une fabrique de joints de caoutchouc. 
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Neanmoins XSLT est jeune, tresjeune. On n'a pas encore le recul necessaire pour juger 
du degre effectif de reutilisabilite que I'on peut atteindre avec des bibliotheques de 
regies : done, en attendant que les experiences s'accumulent et qu'une synthese puisse 
etrefaite, on peut parti r avec I'idee qu'il y a de bonnes cliances que cela fonctionne. 

Ce cliapitre presente les differentes possibilites dans ce domaine. 

Instruction xshinclude 

Syntaxe 

xsl :inc1ude 

<xsl linclude 
href=" ..." 

/> 

L'attribut href nedoit pasetre un descripteur de valeur differee. 
instruction xsi : include doit apparaitre comme instruction de premier niveau. 

Semantique 

L'instruction xsi : include permet d'incorporer au fichier source XSLT courant les ins- 
tructionsXSLT d'un autre fichier sourceXSLT dontl'URI estfourni par l'attribut href. 

Attention 

Pour beaucoup, ce genre d'instruction rappelle evidemment assez fortement la directive #inciude que I'on 
trouve en C ou en C++. C'estvrai qu'il y a beaucoup de ressemblance entre xsi :inciude et#inciude, puisque 
les deuxserventarealiserl'immersion d'un fichier dans le fichier courant, mais il y a une difference essentielle : 
en C ou C++, la directive #inciude est prise en charge par un preprocesseur : or il n'y a pas de preprocesseur 
en XSLT. La consequence, c'estqu'il estpossible d'avoiren C ou C++ des inclusions conditionnelles, en combi- 
n ant directives #inciude et#ifdef, parexemple, alors que c'est absolument impossible en XSLT, au moins 
directement Remarquez bien que l'attribut href est un attribut ordinaire :ecrire un descripteur de valeur differee 
au lieu d'une valeur litterale serait une faute de syntaxe. Inutile done de tenter de fournir une valeur calculee au 
prealable dans une variable. Neanmoins, en cas de necessite, on peuttoujours simulerle fonctionnementd'un 
preprocesseur : on se reportera a la section Pattern n ' 15 -G eneration d \ir\e feuille de style par une autre feuille 
de style, page 507, pourun exemple mettanten oeuvre cette idee. 

L'URI fourni comme valeur de l'attribut href peutetreun nom absolu de fichier ou une 
URL, mais i I peut etre aussi un nom relatif. Dans ce cas, le fichier est cherche dans le 
repertoire courant, defini comme etant eel ui qui contient la feuille de style courante(celle 
qui comporte l'instruction xsi:inciu de). Voir la notion d'URI de base, URI de base 
(remarque en marge de ce texte), page 640. 
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Processus mis en ceuvre 

Si I'on voulait incorporer soi-meme le contenu de la feuille de style referencee dans la 
feuille de style courante, voici ce qu'il faudrait faire pour realiser le meme travail que le 
processeurXSLT : 

• examiner les domaines nominaux declares dans instruction xsi :styiesheet de la 
feuille referencee, et les reporter dans I'instruction xsi :styiesheet de la feuille cou- 
rante ; 

• prelever les instructions xsi : import de la feuille referencee, et les reporter dans la 
feuille courante, en les plagant apres toutes les autres instructions xsi :import qui s'y 
trouvent deja, mais avant toute autre instruction de premier niveau ; 

• prelever les autres instructions de la feuille referencee, et les reporter dans la feuille 
courante, a la place de I'instruction xsi : include concernee (voir figure 7-1, a la sec- 
tion P rocessus mis en auvre, page 381). 

Dans ce processus, on peut etre amene a incorporer des instructions xsi include ou 
xsi : import, qui toutes lesdeux, font reference a des fichiers, identifies par des URI four- 
nis comme valeurs de I'attribut href, commun a ces deux instructions. Si ces URI sont 
des chemins relatifs, 11 peut alors etre necessaire de les modifier en les incorporant, de 
telle sorte qu'ils continuent de referencer les memes fichiers (relativement au repertoire 
de la feuille principale), meme si le repertoire contenant ces fichiers n'est pas le meme 
que celui contenant la feuille principale. 

Si I'on a incorpore des instructions xsi : include, il faut bien sur reiterer entierement ce 
processus. 

I'instruction xsi : import sera vueun peu plus loin (voir Instruction xsi: import, page 381) ; 
la seule chose qui compte ici, c'est de savoir que cette instruction doit etre placee avant 
toute autre sorted' instruction de premier niveau ; c'est ce qui explique qu'il faille prelever 
a part les xsi : import, et les placer au bon endroit pour ne pas contrevenir a cette regie. 

Remarque 

Toutceci montre que le travail realise lors d'un xsi : include est bien plus complique qu'une simple inclusion, 
comme celle que I'on pourrait realiser par un appel d'entite externe, etqui se traduirait par une inclusion brutale 
eten I'etatdu fichier reference. 

Erreurs possibles 

Une reference circulaire (une feuille qui s'inclut elle-meme, directement ou indirecte- 
ment), est interdite, commea I'habitude. 

Par contre, inclure deux fois la meme feuille n'est pas uneerreur en soi, mais peut even- 
tuellement induire des erreurs (par exemple, si la feuille incluse deux fois contient une 
regie xsi :tempiate, celle-ci sera done placee deux fois dans la feuille principale, entrai- 
nant done une ambiguite, puisquerien nelesdepartage; maisil estvrai que certains pro- 
cesseurs peuvent prendre I e parti, dans ce cas, de se recuperer en choisissant la derniere). 
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De toutefagon, inclure deux fois la memefeuille n'est pas pertinent ; c'est toujours une 
faute d'inattention ou de conception, et cela ne devrait jamais etre un but consciemment 
reclierclie. 

General ement, definir deux fois la meme chose dans une feuille de style est une erreur, 
done un xsi :inciucie qui amene dans la feuille principale quelque chose qui s'y trouve 
deja est un xsi :inciude errone. M ais 11 convient de s'interroger ici sur le sens exact de 
cette phrase. Que veut dire en effet «qui s'y trouve deja»? Si la chose est une 
declaration de variable ou de modele nomme, 11 n'y a pas dedoute possible, c'est lenom 
fourni en attribut qui dit si on a un doublon ou non. 

Mais pour une regie de transformation, c'est beaucoup plus subtil, etIeprocesseurXSLT 
ne peut pas toujours conclure au simple examen statique de la feuille de style, et doit se 
contenter de signaler le conflit, s'il survient a I 'execution. Prenons par exemple I 'element 
B de la figure 7-1, a la section Processus mis en o^uvre, page 381 ; si cet element repre- 
sente une regie de transformation avec exactement le meme motif et le meme mode dans 
la feuille principale et dans la feuille inci use, c'est sfir qu'il y a doublon. 

Leprobleme, c'est que meme si on el i mine le doublon B, on n'est pas pourautantal'abri 
d'un conflit. Toujours sur la meme figure (7-1), on peut voir des elements A et D dans la 
feuille resultante apres inclusion. Supposons que ces deux elements soient des regies de 
transformation avec des motifs differents ; meme differents, les deux motifs peuvent tres 
bien concorder simultanement avec un certain noeud. Si ce noeud ne fait jamais I'objet 
d'une recherche de concordance de motif, on passe au traversdesmaillesdu filet. M ais si 
ce noeud esttraite par le processeur, alors immanquabi ement, celui-ci decouvrira les deux 
regies possibles, et I'ambiguite entre A et D sera alors prouvee. 

Enfin, il faut signaler le cas ou B serait une instruction xsi :attribute-set : cette fois, 
meme si I 'attribut name est identi que dans les deux cas, il n'y a pas de conflit (sauf en cas 
d'attributs de meme nom maisdevaleursdifferentes), car les deux attribute-sets sont 
fusionnes. 

On voit done qu'il n'y a pas de regie simple et generale pour determiner si un xsi : 
include est correct OU non, si ce n'est de faire comme si on ecrivait une seule feuille de 
style reunissant la feuille principale et la feuille a inclure, et de veiller en particulier 
(comme d'habi tude) a ne pas ecri re des regl es dont I es motifs ne serai ent pas assez di scri - 
minants pour etre mutuellement exclusifs sur certains noeuds. 

Position des instructions xsl:include 

L es i nstructions xsi : i nci u de peuvent etre placees n'importe ou dans la feuille de style, 
(pourvu qu'elles apparaissent comme instructions de premier niveau), mais il semble 
preferable, en general, de les placer en tete du fichier principal. En effet, si par malheur 
I'inclusion d'une feuille amene une regie ou une definition de variable qui existe deja 
dans la feuille principale, soit on obtient un message d'erreur suite a I'apparition d'un 
ambiguite (et dans ce cas on corrige I 'erreur), soit le processeur accepte I'ambiguite et la 
resout en activant la derniere regie dans I'ordre de lecture du document. Dans ce dernier 
cas, il vaut mieux que la derniere regie soit celle de la feuille principale, cequi implique 
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que ['instruction xsi : include fautivenesoitpas placeeverslafin delafeuilleprincipale, 
mais au contraire au debut. 

Interetde I'instruction xshinclude 

L'interet de cette instruction, c'est de pouvoir recuperer (pour les reutiliser) des modeles 
nommes conserves dans des ficliiers X SLT, et classes dans des bibliotlieques, ou de pou- 
voir fragmenter un programme X SLT monolitliique en plusieurs morceaux pour en faci- 
liter la lecture et la maintenance. 

Dans ces deux cas, le programme X SLT complet est constitue en incluant dans la feuille 
principale les modules desires, et ensuite, tout se passe comme si les instructions qu'ils 
conti ennent avaient ete ec rites di rectement dans I a f eui 1 1 e pri nci pal e. 



Nous prendrons comme exemple I 'utilisation d'une bibliotheque, par exemple la « XSLT 
Standard Library », qui est une bibliotheque « Open Source», maintenue par Steve Balls 
(voir http://xsltsl.sourceforge.net). On y trouve des collections de modeles nommes dans 
differents domaines : Strings, Dates, Nodes, etc. 

Pour illustrer I'utilisation d'une telle bibliotheque, nous allons reprendre I'exemple 
d'annonces de concerts, vu a la section Exemple, page 223. II s'agit de produire un plan- 
ning des concerts, comme ceci : 



N ous partons d'un fichier X M L qui conti ent les annonces : 
annonces.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Annonces> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Annonce> 
<Date> 

<Jour id="niar"/> 
<Quantieme>20</Quantienie> 
<Mois id="nov"/> 
<Annee>2001</Annee> 
<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Llrsules</Lieu> 
<Enseinble> "Le Poeme Harmonique" </Ensemble> 

</Annonce> 

<Annonce> 



Exemple 



Planning 



Semaine 47 
Semaine 3 
Semaine 8 



"Le Poeme Harmonique" 
"A deux violes esgales" 
"Ensemble Baroque de Nice" 
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<Date> 



<Jour icl="jeu"/> 
<Quanti eiiie>17</Quanti eme> 
<Mois id="jnv"/> 
<Annee>2002</Annee> 
<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Llrsules</Lieu> 
<Ensemble> "A deux violes esgales" </Ensemble> 
</Annonce> 
<Annonce> 
<Date> 

<Jour id="dim"/> 

<Quantieine>24</Quantieme> 

<Mois id="mar"/> 

<Annee>2002</Annee> 

<Heure>17H</Heure> 
</Date> 

<LieLi>Chapelle des Llrsules</Lieu> 
<Ensemble> "Ensemble Baroque de Nice" </Ensemble> 
</Annonce> 

<!-- etc. --> 

</Annonces> 

Le programme doit done calculer le No de semaine, connaissant le quantieme, le No de 
mois, eti'annee. Precisement, c'estl'unedesfonctionsdisponiblesdanslaxsltsi (XSLT 
Standard Library) ; il suffit done d'inclure le bon module et d'appeler le bon modele 
nomme : 

planning.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl rstylesheet 

xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xml ns :dt="http: //xsl tsl .org/date-time" 

version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 
<xsl : incl ude href=" . ./ . ./xsl tsl -1 .0/date-time.xsl "/> 
<xsl ivariable name="Dictionnai re" 



select=" document ( 'dictionnai re.xml ' )/Dictionnai re"/> 



<xsl :templ ate match="Annonce"> 



<xsl :vari abl e 

name="quantieme" 
select="./Date/Quantieme" /> 
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<xsl ivariable 
nanie="NoMoi s" 

sel ect="$Dictionnai re/mot [@id=cur rent ( )/Date/Mois/@id]/@num" /> 



<xsl ivariable 
nanie="annee" 

select="./Date/Annee" /> 



<xsl ivariable name="NoSemaine"> 

<xsl ical 1 -tempi ate name="dt ical cul ate-week-number"> 
<xsl iwith-param nanie="year" sel ect="$annee"/> 
<xsl iwith-param name="month" select="$NoMois"/> 
<xsl iwith-param name="day" select="$quantieme"/> 
</xsl icall-template> 
</xsl I vari abl e> 



<xsl itext> 

Semaine </xsl itext> 

<xsl ival ue-of select="$NoSemaine"/> i <xsl :value-of select="./Ensemble"/> 



</xsl itempl ate> 



<xsl itemplate match="text( )" /> 



</xsl istylesheet> 

Pour obtenir le bon numero de mois, on se base comme dans I'exemple (voir Example, 
page 223) de la traduction par dictionnaire (bien qu'il n'y ait pas de traduction a faire 
cette fois-ci), legerement modifie pour faire figurer les numeros de mois (seuls les mois 
utiles sont montres, pour gagner de la place) : 

Dictionnaire.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Dictionnai re> 



<mot id="jnv" num="l"> 

<traduction 1 ang="f r">janvier</traduction> 
<traduction 1 ang="en">january</traduction> 

</mot> 



<mot id="mrs" num="3"> 

<traduction 1 ang="f r">mars</traduction> 
<traduction 1 ang="en">march</traduction> 

</mot> 



<mot id="nov" nuin="ll"> 

<traduction 1 ang="f r">novembre</traduction> 
<traduction 1 ang="en">november</traduction> 

</mot> 



</Dictionnaire> 



Decoupage d'une application XSLT 

Chapitre 7 

Le resultat obtenu est eel ui montre plus haut. 

On observera le domaine nominal impose par xsltsi ("http://xsUsi .org/date-time"), 
associe au prefixe "dt: " qui qualifie le nom du modele a appeler (dt:caicuiate-week- 

number). 

On remarquera aussi au passage I'emploi de la fonction currento, exactement pour la 
meme raison que cellequi a ete vue tout a la fin de la section Exemple, page 187. 

A titredecuriosite, voici le code XSLT correspondantau modele nomme dt:caicuiate- 

week-number : 
date-tiine.xsl (extrait) 

1 <?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<xsl istylesheet 
version="1.0" 

extension-el ement-pref ixes="doc" 
xml ns :xsl ="http: //www. w3.org/1999/XSL/Transform" 
xml ns :doc="http: //xsl tsl .org/xsl /documentation/1 .0" 
xml ns :dt="http://xsl tsl .org/date-time" 

> 

<xsl itemplate name="dt:calculate-julian-day"> 
<xsl:param name="year"/> 
<xsl:param name="month"/> 
<xsl:param name="day"/> 

<xsl :variable naine="a" select="floor((14 - $month) div 12)"/> 
<xsl rvariable naine="y" sel ect="$year + 4800 - $a"/> 
<xsl ivariable name="m" sel ect="$month + 12 * $a - 3"/> 

<xsl :value-of select="$day + floor((153 * $m + 2) div 5) + 

$y * 365 + floor($y div 4) - floor($y div 100) + 
floor($y div 400) - 32045"/> 

</xsl itempl ate> 

<xsl itemplate name="dt:calculate-week-number"> 
<xsl:param name="year"/> 
<xsl:param name="month"/> 
<xsl:param name="day"/> 

<xsl :variable name="J"> 

<xsl :cal 1 -tempi ate name="dt :cal cul ate- Jul ian-day"> 

<xsl :with-param name="year" sel ect="$year"/> 

<xsl :with-param name="month" sel ect="$month"/> 

<xsl :with-param name="day" sel ect="$day"/> 

</xsl :call-template> 
</xsl :variable> 

<xsl ivariable name="d4" select="($J + 31741 - ($J mod 7)) mod 146097 

mod 36524 mod 146r7> 
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<xsl :variable name="L" select="floor($cl4 div 1460)"/> 

<xsl :variable name="dl" select="(($d4 - $L) mod 365) + $L"/> 

<xsl :val ue-of sel ect="f 1 oor ( $dl div 7) + !"/> 
</xsl :teirpl ate> 

</xsl :stylesheet> 

Quand on voit ce a quoi on a echappe, on se dit que finalement, ce n'est pas plus mal 
qu'il existe une XSLT Standard Library , et une instruction xsi nnciude pour s'en ser- 
vir ! 

Instruction xshimport 

Syntaxe 

xsi : import 

<xsl : import 
href=" ..." 

/> 

L'attribut liref nedoit pasetre un descripteur de valeur differee, 

L'instruction xsi : import doit apparaitre comme instruction de premier niveau, etdeplus 
doit apparaitre avant toute autre instruction. 

Semantique 

L'instruction xsi :import permet d'incorporer au ficliier source XSLT courant les ins- 
tructions XSLT d'un autre ficliier source XSLT dont I'URI est fourni par l'attribut href. 
La difference avec xsi : include tient a ceque les conflits, en cas de definitions multiples 
d'une meme instruction XSLT, ne sont pas necessai rement des cas d'erreurs, et peuvent 
etre resolus grace a des regies specifiques. 

L'interpretation de la valeur de l'attribut href se fait comme pour ['instruction xsi: 
include (voir Semantique, page 374). 

Processus mis en ceuvre 

Le processus d'incorporation des instructions XSLT provenant d'une feuille de style 
importeeest le meme que eel ui d'une inclusion (voir Processus mis en cEUvre, page 375). 
Ce qui change, c'est I 'interpretation du resultat une fois I'incorporation terminee. On 
peut exprimer cela assez facilement sur un dessin (voir figure 7-1, ou A, B, C, et D repre- 
sentent des instructions XSLT quelconques) : dans le cas d'une inclusion, la double 
presence de I 'instruction B pose (en general) probleme, mais pas dans le cas d'une 
importation. 
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Figure 7-1 

Comparaison 
inclusion- 
importation. 



Feuille XSLT 



Feuille XSLT 



Feuille XSLT 




Feuille XSLT 




Note 

La figure 7-1 suggere un conflit potentiel entre I'element B de la feuille principale et I'element B de la feuille 
importee. Neanmoins, il fautgardera I'espritqu'une stricte identite d'elementn'estpas necessaire arapparition 
d'un conflit: deux regies de transformation de motifs differents peuvent tres bien engendrer un conflit sur un 
certain nceud, si les deux motifs concordent simultanement avec ce nosud. La figure est ici un support visuel qui 
permetde mettre en evidence les endroits ou I'on discute d'un conflit, mais elle ne doit pas faire croire que les 
conflits ne peuvent pas surgirailleurs. 



Dans le cas d'une importation, le conflit entre les deux instructions B, s'il existe, est 
resolu par la prise en compte d'un indicateur de preseance. Cet indicateur est un entier 
d'autant plus negatif que la preseance est faible : dans le cas de la figure 7-1, le B vain- 
queur estcelui qui provientdelafeuillecourante, (preseanceO), alorsquel'autreB, pro- 
venant de la feuille importee, a la preseance -1 (les valeurs absolues de ces indicateurs 
sont arbitral res : cequi compte, ce sont leurs valeurs relatives). 

Le cas simple, pour le calcul de cet indicateur, est celui oil chaque feuille ne contient 
qu'une seule instruction xshimport ; dans ce cas la valeur absolue de I'indicateur est le 
nombre d' importations qui separe I 'element importe de la feuille courante (voir figure 7-1). 

Dans I'exemple de la figure 7-2, I'element E a la preseance (-2) parce qu'il y a deux 
importations a effectuer pour I'incorporer a la feuille courante. 

Le cas general est celui ou il peut y avoir plusieurs instructions xsi :import dans cer- 
taines desfeuillesXSLT (voir figure 7-3). 
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Figure 7-2 

Importations en 
cascade, calcul 
de la prese'ance. 



Feuille XSLT 



FeuilleXSLT 



Feuille XSLT 



Feuille XSLT 




Feuille resultante 



I- D (-3) 

J-B (-2) 
|-E (-2) 

SBUV 
°\' D (-1) 

^MOT 
a« B (0) 
•C (0) 



Done le dernier sous-arbre d'importations issu du dernier xsi : import, dans I'ordre de 
lecture de la feuille courante, a preseance sur I'avant dernier, qui lui-meme, a preseance 
sur celui qui I e precede, etc. 

Dans notre exemple, cela veut dire que les indicateurs de preseance, pour les elements du 
sous-arbre issu de la feuille (c), sont tous superieurs aux indicateurs affectes aux ele- 
ments du sous-arbre issu de la feuille (b), 

II faut done faire le calcul en partant du dernier xsl : import, et en calculant des indica- 
teurs de preseance toujours de plus en plus faibles : on applique la regie du pipe pour 
choisir une branche, etcelledu nombre d'importations quand on suit une branche. 

A noter que les instructions xsl : i nci u de ont bien sur un effet nul dans ce calcul ; c'est 
pourquoi les elements B des feuilles (f) et (b) ont meme indicateur de preseance. 

Une fois qu'on a les indicateurs de preseance, on s'en sert uniquement s'il y a con^it, 
pour choisi r I 'element a prendre en compte. Si deux elements de meme preseance sont en 
conflit, c'est un cas d'erreur, le processeur XSLT pouvant eventuellement choisir de 
prendre le dernier element dans I'ordre de lecture de la feuille resultante. 

Comme d'habitude, lorsque la detection d'un conflit repose sur une comparaison de 
noms prefixes, 11 ne faut pas se laisser abuser par des prefixes eventuellement differents : 
ce qui compte, ce sont les domaines nominaux, pas les prefixes. 
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Figure 7-3 

Arbred 'importations, 
calcul de la preVance. 



Feuille XSLT 



Feuille XSLT 



Feuille XSLT 




Feuille XSLT 



Feuille XSLT 






• B 


f 







• B 


d 





Feuille resultante 

g|- B (-5) 

f |« B (-4) 

D (-4) 

e|-E (-3) 

d|' B (-2) 

^BTlT 
■^ l' D (-1) 

•A (0) 
a-B (0) 
•C (0) 



Regie du pipe 

Premier importe, premier ecarte : autrementdit, dans une feuille XSLT, la derniere importation, dans I'ordre de 
lecture du document, a la preseance la plus grande. 
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Interetde I'instruction xshimport 

L'instruction xsi : import a un air de famille avec I 'heritage dans les langages a objets : 
une classe A peut lieriter d'une classe B, et dans ce cas A « recupere » les metliodes et 
attributs declares dans B. S'il n'y a aucun recoupemententre les classes A et B, ['heritage 
revient a une simple addition des methodes et attributs de B dans A. M ais A peut aussi 
redefinir certaines methodes de B , ce qui revient a dire que A n'accepte pas tout I 'heritage 
deB tel quel. 

II en va de memeavec xsi : import : si A importeB, il herite des elements definis dans B, 
maisil peut aussi en redefinir certains. 

En resume, xsi nnciude, c'est de I'heritage sans redefinition, alorsquexsi :import, c'est 
de I'heritage avec redefinition possible : on utilise xsi : i ncl u de quand on est satisfait de 
cequ'on recupere, etxsi : import quand on aimeraitbien personnaliser certains elements. 

Example 

L'exemple que nous allons voir va montrer comment personnaliser un element de 
DocBook. 

Note 

Docbookestune DTD associee a des feuilles de style XSLT pour rediger des articles, des livres, etplus generB- 
lementde la documentation. Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook.org). 

J 

A titredecuriosite, void un extraitde document redige en DocBook: 

<?xml version="1.0" encoding="UTF-16" ?> 
<!DOCTYPE article SYSTEM "customdocbook.dtd"> 
<art1cle lang="fr"> 
<articleinfo> 
<author> 

<f i rstname>Phi 1 1 ppe</f i rstname> 

<surnanie>Dr1x</surname> 

<affiliation> 

<jobtitle>Consultant Architectures Objet</jobtitl e> 
<orgname>Objecti va</orgname> 
</affil1ation> 
</author> 

<title>SPECIFICATION XML DU REFERENTIEL METIER DE L' APPLICATION 

CAN0FETE</t1tle> 
<revh1story> 

<revision> 

<revnumber>l .0</revnuniber> 
<date>7-XI-2001</date> 
<author initial s>PhD</authorinitials> 
<revremark>Creation du docuinent.</revreinark> 
</revision> 
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</revhistory> 
</articleinfo> 
<abstract> 

<para>Ce document presente les composants XML de 1 'appl ication 
Canofete, cote referentiel metier, et non cote presentation. 
Ces composants XML sont tous lies au generateur de code Java, 
et decrivent les transactions et les services fonctionnels.</para> 

</abstract> 

<sectl> 

<title>Introduct1on - Structure generale</t1tle> 
<sect2> 

<t1 tle>Fi chier <emphas1s>Cycl aModel .xml </emphasi sX/tltl e> 
<para> 

Le generateur part du fichier 

XML <filename>CyclaModel .xml</filename>, qui 

decrit la correspondance entre les objets metiers et les 

differentes tables de la base de donnees LASSO. 

</para> 

<!-- etc. --> 

</arti cl e> 

DocBook est disponible gratuitement sur le site precite, et apres installation, on obtient 
(entre autres) desfeuilles de style pour un rendu HTML ou FO. 

On peutbien sur utiliser DocBool< tel quel ; maisvoici le debut de la feuillede style prin- 
cipale : 

docbook.xsl 

I <?xml version='1.0'?> 

<xsl : stylesheet xml ns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xmlns:doc="http://nwal sh.com/xsl /documentation/ 1.0" 

excl ude-resul t-pref ixes="doc" 

version='1.0'> 

<xsl:output method="html " 

encoding="IS0-8859-l" 
indent="no"/> 

< 1 -_ it******************************************************************* 

$Id: docbook.xsl ,v 1.6 2001/07/04 16:17:43 uid48421 Exp $ 
★it****************************************************************** 

This file is part of the XSL DocBook Stylesheet distribution. 
See ../README or http://nwalsh.com/docbook/xsl/ for copyright 
and other information. 



<! 



> 
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<xsl 


incl ude 


href= 


" . ./VERSION"/> 


<xsl 


incl ude 


href= 


"param.xsl "/> 


<xsl 


incl ude 


href= 


" . ./I ib/1 ib.xsr/> 


<xsl 


incl ude 


href= 


" . ./common /I lOn .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/common. xsl "/> 


<xsl 


incl ude 


href= 


" . . /common /I abel s .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/ti tl es .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/subti tl es .xsl "/> 


<xsl 


incl ude 


href= 


" . ./common/gentext.xsl "/> 


<xsl 


incl ude 


href= 


"autotoc.xsl "/> 


<xsl 


incl ude 


href= 


"1 ists .xsl "/> 


<xsl 


incl ude 


href= 


"cal 1 out. xsl "/> 


<xsl 


incl ude 


href= 


"verbatim. xsl "/> 


<xsl 


incl ude 


href= 


"graphics. xsl "/> 


<xsl 


incl ude 


href= 


"xref .xsl "/> 


<xsl 


incl ude 


href= 


"formal .xsl "/> 


<xsl 


incl ude 


href= 


"table. xsl "/> 


<xsl 


incl ude 


href= 


"sections. xsl "/> 


<xsl 


incl ude 


href= 


"inline. xsl "/> 


<!-- 


etc. --> 





Lafeuilledestylecommencedonc parun grand nombred'inclusions, etnotammentcelle 

dU fiChier inline.xsl. 

Cefichier ini ine.xsi contient (entreautres) les regies suivantes : 
inl ine.xsl 

<xsl :template name="inl ine.monoseq"> 
<xsl:param name="content"> 

<xsl :cal 1 -tempi ate name="anchor"/> 

<xsl :apply-templates/> 
</xsl :param> 

<tt><xsl :copy-of select="$content"/></tt> 
</xsl itempl ate> 

<xsl :template match="f i 1 ename"> 

<xsl :call-template name="inline.monoseq"/> 
</xsl :templ ate> 

On voit que lecontenu de la balise <fiiename> est rendu en XHTM L sous la forme <tt> 
. . .</tt>. Supposons quecela ne nous plaise pas completement : on voudrait qu'un nom 
declasseCSS soitprecise, afin qu'il puisseetre possiblederegler finementlerendu d'un 
nom defichier, commececi : 

I <tt class="filename">CyclaModel .xml</tt> 

Avec une importation, c'est tres simple a faire : on constitue une feuille principale dans 
laquelle on importe docbook.xsi, puis on redefinit ce qui ne va pas. 
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monDocBook.xsl 

<?xml version='1.0'?> 
I <xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" 
version^'1.0' 

xml ns="http: //www. w3.org/TR/xhtinl 1/transi tional " 
excl ude-resul t-pref ixes="#def aul t"> 

<xsl : import 

href="f i le: ///c: \DocBook\docbook-xsl -1 .45\htnil \docbook.xsl "/> 

<xsl :template naine="inl ine.monoseq"> 
<xsl :param name="cssCl assNanie"/> 
<xsl:param name="content"> 

<xsl : call -tempi ate name="anchor"/> 

<xsl :apply-templates/> 
</xsl :param> 

<tt cl ass=" {ScssCl assName} "Xxsl :CDpy-of sel ect="$content"/></tt> 
</xsl itempl ate> 

<xsl itempl ate match="f i 1 ename"> 

<xsl :call-template name="inl ine.monoseq"> 

<xsl :with-param name="cssCl assName" select=" 'filename "7> 

</xsl :call-template> 
</xsl itempl ate> 

</xsl istylesheet> 

L e resultat est conforme aux attentes. 

Instruction xshapply-imports 

Syntaxe 

xsl : apply- imports 

I <xsl :apply-1mports/> 

L'instruction xsi lappiy-imports ne doit pas apparaitre comme instruction de premier 
niveau. 

Regie XSLT typique 

Une regie XSLT utilisant ['instruction xsi lappiy-imports sera souvent employee 
comme ceci : 

<xsl itempl ate match="... motif (pattern) ..."> 
<xsl iapply-imports/> 



</xsl itempl ate> 
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Semantique 

L'instruction xsi :appiy-imports est une instruction qui ne sert que lorsqu'on redefinit 
une regie de transformation importee (lieritee) d'une autre feuille de style. II y a alors 
deux cas possibles : 

• Le nouveau modele de transformation n'a pas grand-chose a voir avec I'ancien (celui 
qu'on redefinit) ; dansce cas, l'instruction xsi :appiy-imports n'estd'aucun secours, 
inutiledel'utiliser. 

• Le nouveau modele de transformation se contente d'ajouter quelque chose de plus a 
I'ancien ; dans cecas, pourquoi recopier I'ancien ? II vaut beaucoup mieux avoir une 
instruction qui permettededemander I 'application del'ancienne regie : c'est le butde 

xsl :apply-imports. 

Done, lors de I'instanciation de l'instruction xsi :appiy-imports, le processeur XSLT 
relance une recherche des regies dont le motif concorde avec le noeud courant, mais 
limite sa recherche aux regies dont la preseance est plus faible que celle de la regie en 
cours (Processus mis en ceuvre, page 381) ; ces regies sont done necessairement des 
regies importees, et au cas ou plusieurs conviendraient, celle qui a la preseance la plus 
forte est Choi si e. 

Si I'on reprend I'exemple de la figure 7-3, de la section Processus mis en auvre, 
page 381, et que I'on suppose que I'element B, dans la feuille (a), est une regie dont le 
modele de transformation contient l'instruction <xsi :appiy-imports/>, alors I'instan- 
ciation de cette instruction <xsi :appiy-imports/> se traduira par I'application de la 
regie B dela feuille (c), puisque c'est celle dont le motif va a nouveau concorder avec le 
noeud courant, et dont la preseance est la plus forte parmi les feuilles de preseance plus 
faible que celle dela regie en cours. 

Le modele de transformation de la regie trouvee est alors instancie, et cette instanciation 
estcellede l'instruction <xsi :appiy-imports/>. 

Remarque 

L'instanciation d'une instruction <xsi :appiy-iniports/> necessite de connaltre deuxchoses : la regie courante, 
et ie ncBud courant : ia regie courante, parce qu'on en ctierctie une autre de meme mode, (s'ii y en a un), et ie 
noeud courant, parce que ie motif de ia regie ctioisie doit concorder avec ce noeud courant. C'est pourquoi ceia 
n'aurait pas de sens d'instancier une instruction <xsi : apply- imports/> a i'interieurdu modeie de transforma- 
tion d'une instruction <xsi :for-each>, puisque par definition, cette instruction modifie ie noeud courant (etc'est 
ia seuie qui sactiefaire ceia). Pour cette raison, iiestinterditde piacerune instruction <xsi :appiy-imports/> a 
i'interieur d'une instruction <xsi :for-each>. 



Enfin, si I'on reprend I'analogie entre xsl : import et I'heritage des langages a objets, on 
voit immediatement que <xsi :appiy-imports/> reprend I'idee d'un objet qui, lors de 
I'execution d'une methode heritee et redefinie, lance I'execution de la version originale 
de la methode courante (mot cle super en J ava et en Smal Italk), telle qu'on la trouve dans 
la classe heritee. 



Decoupage d'une application XSLT 

Chapitre 7 



Attention 

Neanmoins, il ne feut pas pousser I'analogie trap loin, car dans le cas d'un langage a objets, la methode liee a 
super estconnue a priori, alors que dans le cas de XSLT, on recommence une nouvelle recherche de regie par 
concordance de motif parmi les regies de preseance inferieure, de sorte qu'on peuttres bien selectionnerfinale- 
mentune regie dontle motif n'a pas du toutle meme aspectque celui de la regie coutBnte. 
Dans le cas de la figure 7-3, parexemple (voir Processus mis en ceuvre, page 381), il pourraittres bien se faire 
que I'elementD de la feuille (c) soit une regie de transformation contenantl'instruction <xsi : apply- imports/), 
dontl'instanciation se traduise finalementparl'activation de la regie E de la feuille (e). 

Example 

Nous reprendrons a nouveau comme exemple ce qui est fait dans DocBool< (voir 
Exemple, page 385). instruction <xsi :appiy-imports/> y est utilisee (entre autres) 
pour resoudre elegamment le probleme maintenant decrit. 

On a un certain nombre de balises pour decrire la structure d'un document, parmi les- 
quelles : <para>, <secti>, <sect2>, <chapter>, etc., dont les noms parlentd'eux-memes. 
On a done en consequence, dans docbook.xsi, des regies pour definir le rendu (HTM L 
ou FO) de chacun de ces elements. Par exemple : 

<xsl :templ ate match="para"> 
<P> 

<xsl:if test="position( ) = 1 and parent :: 1 istiteni"> 

<xsl :call-template name="anchor"> 
<xsl :with-param name="node" select="parent: :listitein"/> 

</xsl :cal 1 -tempi ate> 
</xsl :if> 

<xsl : call -tempi ate name="anchor"/> 
<xsl :apply-templates/> 
</p> 
</xsl itempl ate> 

On suppose maintenant que I'on veut ecrire une documentation technique qui mette en 
evidence les evolutions par rapport a la version precedente. Ces evolutions peuvent etre 
des modification, des aj outs, ou des suppressions. Docbook fournitdequoi faire cela. II 

SUffit de rajOUter un attribut revisionflag ( added, deleted, changed) SUr leS elements 

concernes : 

<para revisionflag="added" > 

Le generateur part du fichier 

XML <filename>CyclaModel .xml</filenanie>, qui 

decrit la correspondance entre les objets metiers et les 

differentes tables de la base de donnees LASSO. 

</para> 

Pour beneficier de la prise en charge de cet attribut, il suffit de lancer I'execution non pas 

de docbook. xsl , maiS de changebars . xsl. 
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Voici lafa9on dont est realiseecettefeuillede style: 

changebars.xsl 

<?xnil version="1.0"?> 
<xsl :stylesheet 

xml ns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl : import href="docbook.xsl "/> 

<xsl:param name="show.revisionflag" sel ect=" ' 1 "7> 

<xsl itemplate name="user.heacl.content"> 



<style type="text/css"> 
<xsl :text> 

div. added { background-color: yellow; ) 
div. deleted { text-decoration: line-through; 



span. added { background-color: yellow; ) 
span. deleted { text-decoration: line-through; 

background-color: #FF7F7F; } 
span. changed { background-color: lime; } 



</xsl :text> 
</style> 
</xsl :templ ate> 

<xsl :template match="*[@revisionflag]"> 
<xsl :choose> 
<xsl :when 



test=" 


1 ocal 


-name( . ) 


= 'para' 


or 


1 ocal 


-name( . ) 


= 'section' 


or 


1 ocal 


-name( . ) 


= 'sectr 


or 


1 ocal 


-name( . ) 


= 'sect2' 


or 


1 ocal 


-name( . ) 


= 'sects' 


or 


1 ocal 


-name( . ) 


= 'sect4' 


or 


1 ocal 


-name( . ) 


= 'sects' 


or 


1 ocal 


-name( . ) 


= 'chapter' 


or 


1 ocal 


-name( . ) 


= 'preface' 


or 


1 ocal 


-name( . ) 


= 'itemizedlist' 


or 


1 ocal 


-name( . ) 


= 'varl istentry ' 


or 


1 ocal 


-name( . ) 


= 'glossary' 


or 


1 ocal 


-name( . ) 


= 'bibliography' 


or 


1 ocal 


-name( . ) 


= 'index' 


or 


1 ocal 


-name( . ) 


= 'appendix"'> 



<div class=' {@revisionflag} '> 



div. changed 
div. off 



background-color: #FF7F7F; } 
background-color: lime; } 



span. off 
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<xsl :apply-iinports/> 
</div> 

</xsl :when> 
<!-- ... --> 
</xsl :choose> 
</xsl :templ ate> 

</xsl :stylesheet> 

Vous voyez la simplicite avec laquelle cette modification somme toute non triviale a ete 
realisee : une regie (une seuie), dont ie motif concorde avec tout eiement possedant un 
attribut revisionfiag a ete ecrite. SoD instanciatioD produit un bioc <div> equipe d'un 
attributdeciasseCSS pour ia miseen evidence deia modification apportee, puis ie rendu 
de i 'eiement concerne est iaisse aux regies de ia feuiiie importee, et immerge dans ie bioc 
<div>. A noter qu'on est ici dans un cas ou ie motif de ia regie a seiectionner dans ia 
feuiiie importee est seion toute vraisembiancetres different du motif deia regie courante, 
puisqu'a priori, ii n'est pas question de revisionfiag dans ia feuiiie originaie. 

Evolution 

LeWori<ing Draft XSLT 1.1 a propose d'ajouter une possibiiite de transmettre des argu- 
ments iors de i'appei <xsi :appiy-imports>, suivant ie meme scfiema que pour 
<xsi :appiy-tempiates>. Cette proposition a ete reprise par ie Wori<ing Draft XSLT 2,0. 
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ChapitreS. Patterns de programmation 395 

ChapitreS. Patterns de transformation 443 




Remarque 

Si Ton regarde le Dictionnaire historique de la langue franpaise(Dictionnaire historique de la langue frangaise, 
sous la direction d'Alain Rey, Dictionnaires Le Robert, Paris, 1998), a I'entree Paterne, on trouve : adjectif carac- 
terisant un air de bienveillance paternelle ; derive du latin « pater, pere ». Si I'on regarde ensuite I'arbre de 
derivation du mot latin « pater », I'une des branches mene au franjais « patron ». A I'entree « Patron », on 
trouve (entre autres) : vers 1100, signifie « mcdele, exemple d'un livre », puis devientun terme metier designant 
le mcdele suivant lequel on fabrique un objet L'anglais « pattern » est la forme alteree du moyen anglais 
« patron » (xii^ siecle), emprunte acette epoque au frangais sans changementde sens. 
La boucle est bouclee : le frangais paterne et l'anglais pattern sontdeux mots de la meme origine, etplutotque 
de traduire pattern, je prefere reprendre le mot tel quel ; il serait possible de changer legerement la graphie, pour 
lui redonner un aspect frangais, par exemple en ajoutant un « e » final, mais cela aurait peut-etre tendance a 
derouter les lecteurs habitues a employer ce mot anglais sans trop se poser de questions. 
A noter que l'anglais pattern a deux sens assez differents pour ce qui touche XSLT : il y a pattern au sens de 
motif, pour les attributs match de xsi :tempiate, xsi :key, etc., et 11 y a pattern au sens de design pattern. II 
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Patterns de programmation 



Les patterns de programmation sont des combinaisons d'elements de programmation en 
X SLT qui reviennent souvent dans la pratique. 

Ces patterns ne sont en general pas des butsen sol, mais plutotdesetapesdans le proces- 
sus de creation d'une certaine feuille de style. XSLT estun I angage encore tresjeune, il 
est done certain qu'on est loin d'avoir identifie tous les patterns de programmation. II est 
meme probable que certains patterns n'ont encore jamais ete imagines par personne. II ne 
fautdonc en aucunefa^on considerer ce catalogue commeexhaustif. A u contraire, il faut 
s'attendre a ce qu'il s'etoffedeplusen plus. 



Pattern n° 1 - Inclusion conditionnelle de feuille de style 

Motivation 

L es inci usions conditionnelles sont des inclusions de feuil les de style differentes en fonc- 
tion d'une certaine condition evaluee a I'execution. Les motivations pour realiser de tel- 
les inclusions conditionnelles peuventetreclassees en deux categories : les bonnes et les 
mauvaises. Quoi qu'il en soit, dies se heurteront toujours a une triste realite : c'est stric- 
tement impossible a faire en XSLT, que ce soit d'une fagon directe en utilisant un des- 
cripteur de valeur differee d'attribut href (chose qui n'est pas autorisee par la grammaire 
XSLT), ou par I'une des nombreuses manieres detournees (dont on a trace dans les 
mailing-lists ou forums consacrees a XSL) qui ont ete imaginees par des utilisateurs 
s'acharnant sur ce probleme insoluble. 
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Realisation 

En reprenantnotreclassement entre bonne etmauvaise motivation, on peutdirequ'il y a 
deux manieresdes'en sortir : 

• soit prendre conscience qu'une i ncl usion conditi onnel le est une mauvaise reponse a un 
vrai probleme(danscecas voir si une inversion de perspective entre feuilles incluantes 
et feuilles incluses ne serait pas la bonne solution) ; 

• soit s'orienter vers une solution ou I'on doit ecrire une feuille de style qui produit 
comme resultat une nouvelle feuille de style, dont les instructions xsl : i ncl ude SOnt 
exactement adaptees au cas determine dynamiquement dans la premiere feuille. 

Dans ce dernier cas, ou unefeuilledestyleen genere une autre, reportez-vousa la section 
Pattern n° 15 - G<?n«?ration d'une feuille de style par une autre feuille de style, page 507, 
pourun exemple de realisation illustrant ceprincipe. 

Pour le premier cas, ou I'on doitevaluer la solution de I'inversion de perspective, I'idee 
est la suivante : une feuille de style A (contenant des transformations standard), veut 
inclure conditionnellement une feuille de style B ou C ou D ... (contenant des variantes 
particulieres), a choisir entre plusieurs possibles, en fonction par exemple d'un profil 
d'utilisateur, L'inversion de perspective consiste a creer n feuilles de style principal es B, 

C, D qui toutes, incluent la feuille standard A. L' aspect conditi onnel de I 'affaire est 

alors reporte a un niveau superieur, celui ou on lance I 'execution de la feuille de style : 11 
s'agit de lancer la bonne, en fonction de conditions qui ne sont plus du ressort d'XSLT, 
maisdel'environnementd'execution (shell scripts, servlets, etc.). 



Pattern n° 2 - Fonction 

Motivation 

En XSLT, 11 y a des fonctions predefinies au sens habituel du terme, mais 11 n'y a pas de 
construction, dans le langage, qui permette dedefinir une fonction renvoyant une valeur. 
Ce qui s'en rapproche le plus, c'est le model e nomme, qui peut etre appele avec des argu- 
ments, comme c'estle cas pour unefonction. M ais unefonction renvoi e une valeur, alors 
qu'un modele nomme instancie un modelede transformation. II esttoutefois possible, en 
y mettant un peu du sien cote appelant, d'ecrire un modele nomme qui fait comme si une 
valeur etait renvoyee. 

Realisation 

L'idee est de recuperer le resultat de I'instanciation dans une variable, et de renforcer la 
lisibilite du modele nomme en tant que fonction en utilisant une variable result. 



Modele notnme renvoyant une valeur 



\ <xsl :templ ate naine="xxx"> 
I <xsl :param name="yyy"/> 
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<xsl:param naine="zzz"/> 

<xsl :variable name="result"> 

... corps de la "fonction" ici ... 
</xsl :variable> 

<xsl:copy-of select="$result" /> 
</xsl itempl ate> 

L'instanciation du modele de transformation (i.e. le corps de la « fonction ») a lieu dans 
la variable result ; cette instanciation peutetreabsolument quelconque, et produire une 
chalne de caracteres ou un nombre, ou un node-set sous la forme d' un TST (voir Temporary 
Source Tree, page 192). 

La variable result a un effet essentiel sur la clarte de lecture du modele nomme : elle 
annonce qu'il y a un resultat (done que I'on tente de mimer une fonction), et que c'est 
elle qui va contenir ce resultat. Cette variable n'ayant aucun effet algorithmique propre- 
ment dit, elle pourrait tres bien etre eliminee, si I'on n'avait pas dans I'idee de I'utiliser 
uniquement pour son effet d'annonce. 

Pour que le modele nomme puisse transmettre effectivement quelque chose a I 'appelant, 
il faut done instancier en derniere instruction une copie du resultat, c'est-a-dire de la 
variable result. Ici, une instruction xsi :vaiue-of ne suffirait pas toujours, car il faut 
prevoir lecas oil la variable result contient un TST. Dans cecas, xsi :copy-of est indis- 
pensable pour realiser une copie complete de tout ce qui se trouve dans cette variable ; et 
comme xsi :copy-of est equivalente a xsi :vaiue-of pour des valeurs simples comme 
string OU Number, on peut donc utiliser xsi :copy-of dans tous les cas de figure. 

Appel du modele noirmie renvoyant une valeur 

<xsl :variable name="result-xxx"> 
<xsl :call -tempi ate naine="xxx"> 

<xsl iwith-param nanie="yyy" select=" . . . "/> 
<xsl iwith-param name="zzz" select=" . . . "/> 
</xsl : call -tempi ate> 
</xsl :variable> 

L'appel n'est pas transparent : pour obtenir I 'effet recherche, il faut aussi adopter des 
conventions d'appel. Le resultat renvoye par le modele nomme etant une instanciation de 
modele de transformation, il faut recuperer ce resultat dans une variable lors de l'appel. 
On englobe donc I 'appel proprement dit dans une variable quelconque, qui va representer 
le resultat de l'appel. Dans le canevas ci-dessus, on peut dire que la variable resuit-xxx 
contient le resultat de l'appel de la « fonction » XXX. 



Example 



Fonction index-of 




<!-- renvoie I'indice du debut de 'teststring' dans 'aString' --> 
<!-- renvoie -1 si 'aString' ne contient pas 'testString' --> 
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<xsl itempl ate name="index-of "> 
<xsl:parani name="aString"/> 
<xsl:param nanie="testString"/> 

<xsl :variable naine="result"> 
<xsl :choose> 

<xsl:when test=" contains( $aString, StestString ) "> 
<xsl ivariable name="string-Before"> 
<xsl :value-of 

select="substring-before( $aString, StestString )" /> 
</xsl :variable> 

<xsl :value-of select="l+string-length( $string-Before )" /> 
</xsl :when> 

<xsl :otherwise> 

-1 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl itempl ate> 

Appel de la fonction index-of 

<!-- indice de la premiere apostrophe dans ' stringToSpl it ' --> 
<xsl ivariable naine="indexOf-fi rstApos"> 
<xsl I call -tempi ate name="index-of "> 

<xsl iwith-param name="aString" select="$stringToSplit"/> 
<xsl iwith-param name="testString" select='"&apos;"'/> 
</xsl icall-template> 
</xsl ivariable> 

<!-- indice du premier espace dans 'stringToSplit' --> 
<xsl ivariable name="indexOf-fi rstSpace"> 
<xsl icall-template name="index-of "> 

<xsl iwith-param name="aString" select="$stringToSplit"/> 
<xsl iwith-param name="testString" select= /> 
</xsl icall -template> 
</xsl :variable> 



Pattern n° 3 - Action 

Motivation 

Ici, action s'oppose a fonction. Une fonction renvoie une valeur, alorsqu'une action rea- 
lise un certain traitement. Cequi est tout a fait paradoxal, c'estquelelangageXSLT est 
un langage fonctionnel (embryonnaire, certes, mais pur, en ce sens que la notion d'effet 
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de bord affectant les objets manipules est etrangere au langage) ; et pourtant la notion de 
fonction n'existe pas completement (voir ci-dessus), alors que la notion de modele 
nomme, qui elle, existe bel et bien, correspondrait plutot a la notion d'action realisant un 
certain effet de bord. Le paradoxe disparait quand on remarque que la seule action que 
puisse realiser un modele nomme, c'est instancier un modele de transformation. Cela 
peut se traduire effectivement par un effet de bord, mais c'est un effet de bord qui ne 
concerne pas les objets manipules : 

• soitil affectel'etatdu document resultat a construi re, qui estexterneau programme(il 
n'y a aucun moyen de recuperer dans une variable, ou de quelque autre fa^on, I'etat 
courant du document resultat en cours de construction) ; 

• soitleflux de sortie de I 'instanciation est capture par une variable, qui estainsi definie 
et initialisee simultanement, mais en aucun cas modifiee (done cecas n'est pas un cas 
d'effetdebord). 

Conclusion 

La seule action possible, en XSLT, c'est I'lnstanciation d'un modele de transformation. 

C hoi si r entre fonction et action consistedonc asedemander si I'on prefere obtenir une 
valeurou instancier un model ede transformation : si I'on veut obtenir une valeur, utiliser 
le pattern Fonction ; si I'on veut instancier un modele, utiliser le pattern Action. 



Realisation 

Etantdonne qu'un modele de transformation correspond exactementa la notion d'action, 
la realisation est triviale. La seule question est de savoir si I'on realise une action ano- 
nyme, ou si I'on opte pour une action nommee. Dans ce dernier cas, 11 est bon de 
donner un nom a I 'action qui rappelle explicitement que I 'action est une instanciation. 
Un modele nomme representant une action devrait toujours avoir un nom de la forme 
instancier-xxx, puisqu'il n'y a absolument aucune autre possibilite d'action en XSLT. 

Modele nomine realisant une action 

<xsl : tempi ate name="instancier-xxx"> 
<xsl:parain naine="yyy"/> 
<xsl:parain naine="zzz"/> 

... corps du modele de transformation ici ... 
</xsl itempl ate> 

Exemple 

On veut instancier un caractere de rembourrage (un caractere qui sert a completer une 
chaine, a gauche ou a droite, afin de lui donner une longueur totale exactement egale a 
une certaine valeur). 
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Action instancier-bourre 

<!-- 'bourre' : le caractere de rembourrage avec I'espace comme valeur par defaut --> 

<xsl itemplate naine="instancier-bourre"> 

<xsl:parani naine="bourre" select^"' "7> 

<xsl :val ue-of select="$bourre" /> 
</xsl :template> 

L'algorithme de I'instanciation de ce modele de transformation ne doit pas vous sembler 
d'un interet extraordinaire ni d'une difficulte insurmontable ; mais ce qu'il faut remar- 
quer ici, c'est plutot le nom du modele, qui suit la recommandation indiquee plus haut : 
cette action consistant a instancier de la bourre, on I'appelle « instancier-bourre ». 

A noter que le but premier du rembourrage n'est atteint que si cette action est repetee 
autant de fois que necessaire, mais 5a, c'est un autre probleme: c'est un probleme 
d'iteration, que nous allons voir maintenant. 

Pattern n° 4 - Iteration 

Motivation 

En XPath, il n'y a pas d'instruction pour realiser une iteration sur une action. L'instruc- 
tion xsi :for-each, malgre son nom, n'est pas une instruction d'iteration, mais une ins- 
truction pour changer temporal rement de noeud courant. Or 11 arrive assez frequemment, 
memeen XSLT, qu'il faille iterer une action, notamment lorsqu'on manipuledeschaines 
decaracteres (mais bien entendu, 11 n'y a pas de domaine reserve). 

II y a deux grandes techniques pour iterer une action; la premiere c'est I'iteration 
recursive, eti'autre, c'est I'iteration Piez, du nom deson inventeur. 

Etant donne I 'absence d'effet de bord, cela n'aurait aucun sens de vouloir iterer sur un 
appel defonction en XSLT : ceserait comme demander 5000 fois son prenom aquelqu'un. 

Realisation recursive 

L'ideeest ici d'envelopper Paction a iterer dans un modele nomme qui va s'appeler n fois 
recursivement, n etant le nombre d'iterations a effectuer. Si vous n'etes pas tres a I'aise 
avec la recursion, I'iteration recursive est un bon moyen d'entrer en douceur dans le 
monde fascinant des abymes. Nous aurons I'occasion de detainer la fagon de concevoir 
unefonction ou une action recursive, mais ici, il s'agit simplement de repeter n fois une 
action ; le plan etant toujours le meme, il n'y a pas lieu de s'appesantir. 

Ingredients : 

• instancier-xxx : le nom de I'action a repeter (sans oublier ses eventuels arguments) ; 

• n : le nombre d'iterations demande; 



iter-instancier-xxx : le nom de I'action iterante. 
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Note 

Repetern fois une action, c'estune action. 0 rune action doit avoir un nomde la forme instancier-xxx, Effec- 
tivement, si I'on suitcette regie, on ne devraitpas nommer Taction iterante iter-instancier-xxx, mais plutot 
instancier-repetitions-de-instancier-xxx. Apres tout, vous feites comme vous voulez, mais moi, je 
prefere la version abregee. 

Model e nomine realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 
<xsl:param name="n"/> 
<xsl:parani name="..."/> 

<xsl :if test="$n > 0"> 

<xsl icall-template naine="instancier-xxx"> 

<xsl iwith-param name^"..." sel ect=" . . . "/> 
</xsl : call -tempi ate> 

<xsl :cal 1 -tempi ate name="iter-instancier-xxx"> 
<xsl :with-param name="n" select="$n - !"/> 
<xsl :with-param name="..." sel ect=" . . . "/> 
</xsl :call-template> 
</xsl :if> 
</xsl itempl ate> 

II faut remarquer ici que la recursion employee est diteterminale, cequi signifieque lors 
de I'execution de Taction iter-instancier-xxx, Tappel recursif est la derniere instruc- 
tion a etre executee. Cette propriete est extremement avantageuse pour Timplementa- 
tion : 11 est inutile de traiter I 'appel recursif en tant que tel, et I e processeur XSLT, pour 
peu qu'il sache se livrer a quelques optimisations de base, va pouvoir remplacer Tappel 
recursif par une simple boucle, ce qui sera beaucoup plus economique en terme de 
memoire consommee. 

Evidemment, une variante de ce pattern pourrait etre d'instancier directement des 
instructions XSLT a la place de Tappel a instancier-xxx, comme ceci : 

Model e nomine realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 
<xsl :param name="n"/> 
<xsl:param name="..."/> 

<xsl :if test="$n > 0"> 

<!-- instancier ici directement des instructions XSLT --> 

<xsl :call-template name="iter-instancier-xxx"> 
<xsl :with-param name="n" select="$n - !"/> 
<xsl :with-param name="..." sel ect=" . . . "/> 
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</xsl :call-teniplate> 
</xsl :if> 
</xsl itempl ate> 



Exemple 

iterations.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl istylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" versiDn="1.0"> 



<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl itempl ate name="instancier-bourre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bourre" /> 
</xsl :templ ate> 

<xsl itemplate name="iter-instancier-bourre"> 
<xsl iparam name="n"/> 
<xsl:param name="bourre"/> 



<xsl :if test="$n > 0"> 

<xsl : cal 1 -tempi ate name="instancier-bourre"> 

<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl :call-template> 

<xsl :cal 1 -tempi ate name="i ter-instancier-bourre"> 
<xsl :with-param name="n" select="$n - !"/> 
<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl :call-template> 
</xsl :if> 
</xsl :templ ate> 

<xsl :templ ate match="/"> 

<xsl :cal 1 -tempi ate name="i ter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl : call -tempi ate> 
</xsl itempl ate> 



<xsl itemplate match="text( ) "/> 



</xsl istylesheet> 

Resultat 
I 

L e programme ci-dessus, qui peut etre applique a n'importe quel document source XML, 
reprend I'action instancier-boLirrevueplushaut(voirPattern n°3-Action, page 398), 
et la repete sept fois, avec le caractere ' . ' comme caractere de rembourrage. 
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Si I'on voulait, il seraittres facile de recuperer leflux de sortie decette instanciation pour 
le rediriger vers une variable : 

Recuperation du flux de sortie dans une variable 

<xsl : tempi ate niatch="/"> 

<xsl :variable name="rembourrage"> 

<xsl :cal 1 - tempi ate naine="iter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl iwith-param name="bourre">.</xsl :with-param> 
</xsl : call -tempi ate> 
</xsl : vari abl e> 

... utilisation de la variable Srembourrage ... 
</xsl :templ ate> 

Iteration par la methode de Piez 

Cette forme d'iterati on a ete inventee par Wendell Piez, et a ete posteesur la listede dis- 
cussion XSL www.mulberrytech.com/xsl/xsl-list). Elle est basee sur un principe total ement 
different, qui consiste a utiliser instruction xsi :for-each, bien qu'elle ne soit pas du 
toutfaite pour 5a. 

Supposons qu'on aitun node-set NS quelconque, pourvu qu'il possede suffisamment de 
noeuds. Suf/zsamment signifie ici au moinsautantdenoeuds qu'il y a detours de boucle a 
effectuer, mais il peuty avoir beaucoup plus de noeuds que necessaire, peu importe. 

Soit n le nombre de tours de boucle que Ton veut effectuer On peut alors realiser la boucle 
commececi : 

Iteration Piez 

<xsl :for-each select="$NS[ positionO < $n+l ]" > 

<xsl :cal 1 -tempi ate name="instancier-xxx"> 

<xsl :with-param name="..." select=" . . . "/> 
</xsl :call-template> 

</xsl :for-each> 

L'astuce consiste a utiliser un predicat qui selectionne exactement n noeuds a partir du 
node-set NS. Cela fait, il est clair que instruction xsi :for-each va instancier exactement 
n fois son modelede transformation, et c'est bien la le but de la manoeuvre. 

Reste un leger detail a traiter : comment obtenir un node-set quelconque d'au moins n 
noeuds? II y a evidemment plusieurs reponses possibles. L'uned'entre elles, qui fonc- 
tionne general ement tres bien, est de recuperer les noeuds de I'arbreXM L correspondant 
au programme XSLT lui-meme(qui, nel'oublionspas, estun documentXML commeun 
autre). Get arbre XML est recuperable grace a la fonction predefinie documento : 
I'appel document{ ' ' ), avec une String vide en argument, renvoie le node-set constitue de 
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la racine de I'arbre X M L du programme X SLT dans lequel elle est contenue. U ne fois 
qu'on a la racine, 11 n'y a plus qu'a selectionner tous les elements enfants, par exemple : 

clocument( ' ' )//nocle( ) 

Evldemment, cela nefonctionnequesi la valeurden n'estpastrop grande. En effet, pour 
desgrandes valeursden, on risque d'avoir un node-set trop petit ; et memesi I 'on s'inge- 
niaitaaller ramasser des noeuds ailleurs, cela deviendrait un peu delirantdeconstituer un 
node-setenorme, juste pour faire une iteration, alors qu'une iteration classique recursive, 
avec recursion terminale, ne consomme pas de memoi re. 

Exemple 

iterations.xsl 

<?xnil version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" versiDn="1.0"> 
<xsl:output method^'text' encoding='IS0-8859-r /> 
<xsl : variabl e name="Pui tsDeNoeuds" sel ect="docuinent( ' ' )//node( ) "/> 

<xsl itemplate naine="instancier-bDurre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bDurre" /> 
</xsl :templ ate> 

<xsl itemplate naine="iter-instancier-bourre"> 
<xsl iparam name="n"/> 
<xsl:param name="bourre"/> 

<xsl :for-each select="$PuitsDeNoeuds[ positionO < $n+l ]" > 
<xsl icall-template name="instancier-bourre"> 

<xsl :with-param name="bourre" sel ect="$bourre"/> 
</xsl : call -tempi ate> 
</xsl :for-each> 
</xsl :templ ate> 

<xsl :templ ate match="/"> 

<xsl :cal 1 -tempi ate name="i ter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 
Resultat 



I 
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Pattern n° 5 - Recursion 

Motivation 

Peut-etre pensez-vous que grace aux techniques d'iteration que nous venons de voir, 
vous allez pouvoir ecliapper a la recursion. M aliieureusement, ce n'est pas vrai : un 
probleme aussi simple que de prendre tous les elements <pn"x devise^" . . . "> d'un 
document XML, et d'en calculer la somme, en tenant compte du taux de change 
actuel, ne peutetre resolu sans recursion, a cause de I'impossibilite qu'il y a de met- 
tre a jour une variable. Avoir une possibilite d'iteration ne resout que la moitie du 
probleme. 

Dans un tel cas, la seule possibilite est d'etablir une definition recursive de la valeur a 
calculer, et de coder cette definition en XSLT, 

II est done indispensable de savoir definir un traitement recursif. 



Realisation 

D'unemanieregenerale, il faut 3 ingredients pour reussiraecrireunefonction recursive : 

1) un parametre numerique n significatif de la complexity de la mise en ceuvre de cette 
definition, 

2) une solution triviale pour une valeur faible den, en general 0 ou 1, 

3) un moyen trivial d'obtenir la solution pour la valeur n du parametre, quand on connatt 
une solution pour la valeur n-i. 

II peut arriver que le point 1) soit implicite : par exemple une fonction traitant une 
chaine de caracteres peut tres bien reposer sur la longueur de cette chaine, qui 
devient alors implicitement le parametre numerique donnant la complexity de mise 
en oeuvre. 

Un autre point essentiel est qu'il nefaut pas chercher a decrire un algorithme, mais uni- 
quement a definir lafonction ; c'estdeja vrai avec des langagescommejava, C ou Eiffel, 
mais ga I 'est encore pi us en XSLT, qui est assez remarquabledans son pouvoir de rendre 
hermetique ce qui n'est pourtant pas si complique. 

II n'est guere possible de continuer en restant dans les generalites ; il faut maintenant 
prendre un exemple. 



Exemple du decompte de mots dans une chaine 

Nous avons une chaine de caracteres constitute de mots separes par un espace. On peut 
supposer que cette chaine est renvoyee par la fonction predefinie normal ize-space( ), de 
sorte qu'il n'y a certainement aucun espace ni en tete, ni en fin, et aucune sequence 
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de plus d'un espacea I'interieur. Le probleme est de compter les mots, ou, cequi revient 
a peu pres au meme, de compter les espaces. 

II s'agit maintenant de formuler une definition recursive du nombre d'espaces d'une 
chaine : 

nombreEspaces( str ) = 

I 0 si la chaine str ne contient auncun espace; 

' 1 + nombreEspaces( substring-after( str, ' ') ) sinon. 

La fonction predefinie substring-afterc stri, str2 ) renvoie la sous-chaine de stri 
situeeapresia premiere occurrence de str2 dans stri ; done ici substring-after ( str. 
■ ' ) va renvoyer la partiede str constitueedes caracteres de str situes apres le premier 
espace de str. 

Vous voyez a quel point la definition de cette fonction est simple ; mais surchargee de 
tout lefatras lexical deXSLT, elledevientassez peu lisible: 

Fonction nombreEspacesC str ) 

<xsl itemplate naine="nombreEspaces"> 
<xs1:param nan)e="str"/> 
<xs1 ivariable naine="result"> 
<xsl :choose> 

<xsl:when test="contains( $str, ' ' ) "> 

<xsl ivariable naine="nombreEspaces-recursif "> 
<xsl : call -tempi ate name="noinbreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 
</xsl :call-teniplate> 
</xsl :variable> 

<xsl :value-of select="l + SnombreEspaces-recursif " /> 
</xsl :when> 
<xsl :otherwise> 

0 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t"/> 
</xsl itempl ate> 

Notez que la definition que nous avons adoptee n'est pas compatible avec le cas favo- 
rable d'une recursion terminale. En effet, la definition recursive de cette fonction pro- 
voque un appel recursif, puis I 'addition du resultat obtenu a 1. C'est ce « puis » qui est 
desastreux, 

Pour revenir a une definition qui autorise une recursion terminale, I'astuce consiste gene- 
ral ement a reporter I ecalcul post-appel au niveau des arguments, pour en faireun calcul 
pre-appel. 



PattErn n° 5 - Recursion 

Chapitre 8 



En clair, cela signifie qu'il faut ajouter un nouvel argument, nombre-courant, qui 
contient le nombre d'espaces deja rencontres : 

notnbreEspacesC str, nombre-courant ) = 

I nombre-courant si la chaine str ne contient auncun espace; 

I nombreEspacesC substring-after( str, ' '), nombre-courant + 1 ) sinon. 

Pour avoir le nombre d'espaces d'unechaines, on calculenombreEspaces( s, o ). 

LorsdeSdifferentsappelsreCUrsifSnombreEspacesC str, nombre-courant ), str repreSente 

unechainedeplus en pluscourte, et nombre-courant un nombre de pi us en plus grand. 

Remarquons enfin que nous avons fait ici le choix d'une fonction et non d'une action. A 
nouveau, ce clioix n'est pas compatible avec une recursion terminal e, puisqu'une fonction 
setermineparun xsi :copy-of. 

Passer d'une fonction a une action est tres simple : il suffit de changer le nom de la fonction 
en nom d'action (instancier-xxx), et de reconstruire les phrases de definition a partir du 
verbe instancier : 

instancier-noinbreEspaces( str. nombre-courant ), c'est : 

- instancier nombre-courant si la chalne str ne contient auncun espace; 

- instancier-nombreEspaces( substring-after( str, ' '), nombre-courant + 1 ) 
sinon. 

Action instancier-nombreEspaces( str, nombre-courant ) 

<xs1 : tempi ate name="instanc1er-nombreEspaces"> 
<xsl:param name="str"/> 

<xsl:param name="nombre-courant" select^" '0' "/> 
<xsl :choose> 

<xsl iwhen test="contains( $str, ' ' ) "> 

<xsl :cal 1 -tempi ate name="instancier-nombreEspaces"> 
<xsl iwith-param name="str" 
select="substring-after( $str, ' ')"/> 

<xsl iwith-param name="nombre-courant" 
select="l + $nombre-courant"/> 
</xsl :call-template> 
</xsl :when> 
<xsl :otherw1se> 

<xsl :value-of sel ect="$nombre-courant"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 

Cettefois, on a bien une recursion terminale, qui pourra done etre optimisee en iteration 
par leprocesseurXSLT. Ci dessous, un programme complet, avec les deux methodes. On 
utilise le fait que le parametre nombre-courant possede la valeur 0 par defaut. A insi, lors 
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de I'appel initial (voir variable n2, a la fin du programme), il n'est pas besoin de transmettre 
explicitement cette valeur initiale. 

NoinbreMots.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transforin" 
version="l.l"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output method^'text' encoding='IS0-8859-r /> 



<xsl itemplate naine="nombreEspaces"> 
<xsl:param nanie="str"/> 
<xsl :variable naine="result"> 
<xsl : choose> 

<xsl :when test="contains( $str, ' ' ) "> 

<xsl ivariable name="nombreEspaces-recursif "> 
<xsl icall-template name="noinbreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl :value-of select="l + $nombreEspaces-recursi f " /> 
</xsl :when> 
<xsl :otherwise> 

0 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl :copy-of sel ect="$resul t"/> 
</xsl :templ ate> 

<xsl itempl ate naine="instancier-nDmbreEspaces"> 
<xsl:param name="str"/> 

<xsl:param nanie="nombre-courant" select=" '0"7> 
<xsl :choose> 

<xsl:when test="contains( $str, ' ' ) "> 

<xsl :cal 1 - tempi ate nanie="instancier-nombreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 



<xsl iwith-param name="nonibre-courant" 
select="l + $nombre-courant"/> 
</xsl :call-template> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="$nombre-courant"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 
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<xsl :variable name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de I'energie 
</xsl :variable> 

<xsl : tempi ate match="/"> 
<xsl ivariable name="Nl"> 

<xsl :cal 1 -tempi ate name="nombreEspaces"> 
<xsl :with-param name="str" 

sel ect="normal ize-space($compl ainteDuCharretier) "/> 
</xsl :call-template> 
</xsl :variable> 

Nombre de mots = <xsl :value-of select="l + $Nl"/> 

<xsl ivariable name="N2"> 

<xsl :cal 1 -tempi ate name="instancier-nombreEspaces"> 
<xsl iwith-param name="str" 

sel ect=" normal ize- space ($compl ainteDuCharretier) "/> 
</xsl :call-template> 
</xsl :variable> 

Nombre de mots = <xsl :value-of select="l + $N2"/> 
</xsl itempl ate> 



<xsl :template match="text( )"/> 



</xsl :stylesheet> 
Resultat 

I Nombre de mots = 10 
Nombre de mots = 10 



Pattern n° 6 -Visiteur recursif de node-set 

Motivation 

II esttres frequent, en programmation XSLT, que Ton aitconstitue un node-set de noeuds 
possedant unecertaine propriete, et que I'on veuille alorsappliquer un certain traitement 
a chacun de ces noeuds. Par exemple, on peut vouloir calculer la somme des valeurs 
numeriques de ces noeuds (a supposer qu'ils aient effectivement une valeur numerique), 
ou bien faire une statistique quelconque, comme indiquer la valeur minimale, ou la 
moyenne, ou tout autre chose du meme genre. 

II y a bien une fonction predefinie sum( ), qui prend en donnee un node-set, et renvoie la 
somme des noeuds du node-set, a condition bien sur que la valeur textuelle de ces noeuds 
soit numerique. M ais d'une part, une somme n'est jamais qu'un aspect des choses, et 11 
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n'y a pas que des additions dans la vie ; et d'autre part, meme si on veut justement calculer 
une somme, rien ne dit que la fonction sumo soit la bonne solution, car I 'experience 
montre que les valeurs a sommer sont rarement purement numeriques. 

Si I 'on veut sommer des surfaces (pour des pieces de maison, par exemple), il y a toutes 
les chances que les val eurs se presentent sous la forme « 15m2 », ce qui se tradui ra par un 
magnifique« NaN » (Not a Number) commeresultat final. 

Typiquement, ce qu'il faut pour resoudre ce genre de probleme de fagon generique, c'est 
un visiteur, qui definisse ce qu'est la valeur d'un noeud, la fa^on de visiter le node-set, et 
Paction a faire a chaque noeud rencontre, 



Remarque 

II ne s'agit pas ici d'une visite arborescente : on a un node-set, eton se contente de visiter chaque noeud, sans 
alter explorer tes descendants de ces noeuds. Ce ne serait pas forcement sans interet, mais a chacun son 
travail : des qu'il s'agit de naviguer dans tes arborescences, XPath est la pour ga ; a nous de lui demander un 
node-set qui contienne toutce qu'il nous faut, sans etre oblige de finir le travail de navigation. 



Realisation 

Pour realiser un visiteur, il fautd'abord ledefinir recursivement. Nous allons tout de suite 
faire le choix d'un visiteur sous forme d'action, et nous inspirer de I'exemple precedent 
pour obtenir une recursion terminale. 

U n visiteur doit renvoyer un resultat, etant donne un node-set ns. Ce resultat sera calcule 
en fonction de la valeur des differents noeuds du node-set ; il faut done supposer qu'on a 
une fonction vaieuro, qui renvoie la valeur d'un noeud. Cette notion de valeur est bi en 
sur susceptible de changer d'un visiteur a I 'autre, en fonction de la semantique du resultat 
a obtenir. 

On suppose enfin que Ton dispose d'une fonction resuUatc ), qui prend en donnee un 
resultat partiel et la valeur d'un noeud, et qui renvoie un nouveau resultat partiel, mais 
actualise en fonction du noeud pris en compte, 

Ceci suggerefortement une partition du node-set a traiter : etant donne un node-set ns, on 
peuttoujoursleconsiderercommeetantforme des noeuds ns[position() > i] (c'est-a- 
dire, tous les noeuds sauf le premier) et du noeud ns[position( ) = i] (c'est-a-dire, le 
premier noeud). 

L'action a definir sera done Taction instancier-resultat, dont le cas trivial se reduit a 
instancier le resultat partiel auquel on est parvenu : 

instancier-resu1tat(ns, resultat-courant) , c'est : 

- instancier resultat-courant si ns est vide; 

- instancier-resultat( ns[position( ) > 1], 

resultat( 

resultat-courant, 
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valeur(ns[position( ) = 1]) 

) 

) sinon. 

On peut Verifier que cette definition estbien recursive terminale. 

U ne fois obtenue, elle doit etre declinee suivant les diverses semantiques possibles 
attacliees aux fonctions resuitat( ) et vaieurc ). Par exemple la fonction resui tat( ) 
pourra renvoyer le plus petit de ses deux arguments, ou leur somme, ou tout autre 
calcul a partir de ces deux arguments, sachant que le premier represente un resultat 
parti el. 



Application 

Minimum d'un node-set 

Soit par exemple le fichier XML suivant, contenant des descriptions de maisons : 
Maisons.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<mai sons> 

<maison id="l"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface='15m2'> 
Bibliotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palinier en zinc figurant le desert. </terrasse> 
<chambre surface='28m2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='r> 
Lambri s . 

</al cove> 
</chainbre> 

<chambre surface='18m2'> 

Lambri s . 
</chainbre> 
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<salleDeBains surface='15ni2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</niaison> 
<maison id="2"> 
<RDC> 

<cuisine surface='12in2'> 

en ruine. 
</cu1sine> 
<garage/> 
</RDC> 
<etage> 

<mirador surf ace="lm2"> 

Vue sur la mer. Ideal en cas de tempete. 
</mi rador> 

<salleDeBains surface='15ni2'> 

Douche. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="3"> 
<RDC> 

<sejour surface='40m2'> 

Les plaisirs ont choisi pour asile 
Ce sejour agreable et tranquille. 
Que ces lieux sent charmants 
Pour les heureux amants. 
</sejour> 
</RDC> 
<etage> 

<chainbre surface='17.5m2'> 

Exposition plein sud. 
</chambre> 
</etage> 
</niaison> 
</maisons> 

On souhaiteconnattrela piece de plus petite surface, parmi toutes les mai sons disponibles. 

Pour cela, nousallons mettreen place un visiteur, associe a unefonction vaieurc ) qui va 
renvoyer la valeurcalculeedel'attri but surface, quand 11 estdisponible, etia valeursym- 
bolique NaN (Not a Number), quand 11 est absent. La valeur calculee de cet attribut est la 
chaine privee de I 'unite (m2), afin d'obtenir une valeur numerique correcte permettant 
les comparai sons : 

fonctlon valeurO 



<xsl :templ ate naine="val eur"> 

<xsl:parani nanie="unSingleton"/> 
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<xsl :variable name="result"> <!-- une surface --> 

<xsl ivariable name="surface" select="$unSingleton/attribute: :surface"/> 

<xsl :choose> 

<xsl :when test="$surface"> 

<xsl :val ue-of sel ect="substring-before( Ssurface, 'm' )" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of sel ect="number( ' NaN ' ) " /> 
</xsl :otherwise> 
</xsl : choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

Lafonction resuitato sera ici lafonction minimumo, avec unesemantiquequi doitres- 

ter COnforme a Ce qui a ete defini plus haut : il faut que minimumC minirtium-courant, 

nouveiieVaieur ) renvoieun nouveau minimum courant, integrant la prise en comptede 
nouveiievaieur, ce qui ne semble pas d'une difficulte insurmontable : 

fonction iiiininiuin( ) 

<xsl : tempi ate name="minimuni"> 
<xsl:parain naine="vr7> 
<xsl:parain naine="v2"/> 

<xsl ivariable name="result"> 
<xsl :choose> 

<xsl :when test="string($vl) = 'NaN' and string($v2) = 'NaN'"> 

<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = 'NaN"'> 

<xsl :val ue-of select="$v2" /> 
</xsl :when> 

<xsl :when test="string($v2) = 'NaN"'> 

<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="$vl > $v2"> 

<xsl :val ue-of select="$v2" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl :val ue-of select="$vl" /> 
</xsl :otherwise> 
</xsl : choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resu1 t" /> 
</xsl :templ ate> 

M aintenant, 11 n'y a plus qu'a integrer ceci dans un programme d'essai, et a coder en 

XSLT la definition recursive du visiteur (nomme instancier-min). 
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SurfaceMini .xsl 



<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method^'text' encoding='IS0-8859-r /> 



<! 



> 



<xsl itempl ate naine="val eur"> 

<xsl:parani nanie="unSingleton"/> 

<xsl ivariable naine="result"> <!-- une surface --> 
<xsl :variable naine="surface" 
sel ect="$unSingl eton/attribute: :surf ace"/> 

<xsl :choDse> 

<xsl :when test="$surf ace"> 

<xsl :value-of select="substring-before( $surface, 'm' )"/> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="number( 'NaN' )" /> 
</xsl :otherwise> 
</xsl :chDose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 

< ! -- ============================================================== --> 

<xsl itempl ate name="minimum"> 

<xsl:param name="vl"/> 

<xsl:param name="v2"/> 

<xsl ivariable name="result"> 
<xsl :choDse> 

<xsl iwhen test="string($vl) = 'NaN' and string($v2) = 'NaN"'> 

<xsl :value-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = 'NaN'"> 

<xsl :value-of select="$v2" /> 
</xsl :when> 

<xsl iwhen test="string($v2) = 'NaN'"> 

<xsl :value-of select="$vl" /> 
</xsl :when> 

<xsl :when test="$vl > $v2"> 

<xsl :value-of select="$v2" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl : val ue-of select="$vl" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 
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<xsl:copy-of sel ect="$resul t" /> 
</xsl itempl ate> 



<! 



> 



<xsl :template name="instancier-min"> 
<xsl:parain naine="unNodeSet" /> 
<xsl:parain naine="min-courant" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl :cal 1 - tempi ate naine="instancier-min"> 
<xsl :with-param nanie="unNodeSet" 

select="$unNodeSet[positionC) > !]"/> 

<xsl :with-param nanie="min-courant"> 
<xsl :cal 1 -tempi ate nanie="mininium"> 

<xsl :with-param name="vl" select="$min-courant"/> 

<xsl :with-param name="v2"> 

<xsl :call-template name="val eur"> 

<xsl :with-param name="unSingleton" 
select="$unNodeSet[position( ) = !]"/> 
</xsl :call-teniplate> 
</xsl :with-param> 
</xsl :call-template> 
</xsl :with-param> 
</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :val ue-of select="$min-courant" /> 
</xsl :otherwise> 
</xsl :choose> 

</xsl :templ ate> 

<!-- ============================================================== --> 

<xsl itempl ate match="/"> 

<xsl ivariable name="surface-mini "> 

<xsl :cal 1 -tempi ate name="instancier-min"> 

<xsl iwith-param name="unNodeSet" sel ect="//*"/> 
<xsl iwith-param name="min-courant" sel ect="1000000"/> 
</xsl :call-template> 
</xsl :variable> 

Surface mini = <xsl :val ue-of select="$surface-mini" />m2 
nature de la piece = <xsl :value-of sel ect="l ocal -name( 



//*[attribute: isurface = 

concat($surface-niini . 'm2')])" /> 



</xsl itempl ate> 



<! 



> 
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|<xsl itempl ate match="text( ) "/> 
</xsl :stylesheet> 
Resultat 

I Surface mini = ImZ 
nature de la piece = mirador 

Somme des valeurs d'un node-set 

En conservant le meme fichier X M L, on peut maintenant calculer, pour chaque maison, 
la surface habitable. La fonction vaieuro ne change pas; la fonction resuitato 
devient ici une fonction sommec ), dont le premier argument est la somme deja obtenue, et 
le deuxieme une nouvelle valeur a sommer Le visiteur est implemente sous le nom 

i nstanci er-somme. 



SurfaceHabitable.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl istylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method^'text' encoding='IS0-8859-r /> 



<xsl :templ ate name="val eur"> 

<xsl :param name="unSingleton"/> 



<xsl rvariable name="result"> <!-- une surface --> 
<xsl :variable name="surface" 

select="$unSingl eton /attribute: : surface" /> 

<xsl :choose> 

<xsl :when test="$surf ace"> 

<xsl :value-of select="substring-before( $surface. 'm' )" /> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="number( 'NaN' )" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :templ ate> 



<i-- 

<xsl itempl ate name="Somme"> 
<xsl:param nanie="vl"/> 
<xsl:param name="v2"/> 



<xsl :variable name="result"> 
<xsl : choose> 

<xsl :when test="string($vl) = 'NaN' and string($v2) = 'NaN"'> 
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<xsl :val ue-of select="$vl" /> 
</xsl :when> 

<xsl :when test="string($vl) = 'NaN"'> 

<xsl :val ue-of select="$v2" /> 
</xsl :when> 

<xsl :when test="string($v2) = 'NaN'"> 
<xsl :val ue-of select="$vl" /> 

</xsl :when> 

<xsl :otherwise> 

<xsl :val ue-of select="$vl + $v2" /> 

</xsl :otherwise> 



<xsl rtemplate name="instancier-soinme"> 
<xsl :param name="unNodeSet" /> 
<xsl:parain naine="somme-courante" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl icall-template naine="instancier-somme"> 
<xsl iwith-param name="unNodeSet" 

select="$unNodeSet[position() > !]"/> 

<xsl iwith-param nanie="soinnie-courante"> 
<xsl icall-template name="Somine"> 
<xsl iwith-param name="vl" 

sel ect="$somine-courante"/> 

<xsl iwith-param name="v2"> 

<xsl icall-template name="val eur"> 

<xsl iwith-param name="unSingleton" 
select="$unNodeSet[position() = !]"/> 
</xsl I call -tempi ate> 
</xsl iwith-param> 
</xsl icall-teinplate> 
</xsl iwith-param> 
</xsl I call -tempi ate> 
</xsl iwhen> 

<xsl iotherwise> 

<xsl ival ue-of sel ect="$somme-courante" /> 
</xsl iotherwise> 
</xsl ichoose> 



</xsl ichoose> 
</xsl I vari abl e> 

<xslicopy-of sel ect="$resul t" /> 
</xsl itempl ate> 



<! 



> 



</xsl itempl ate> 
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<! 



> 



<xsl itempl ate match="maison"> 

<xsl ivariable name="surface-habitable"> 

<xsl :call-template name="instancier-somme"> 

<xsl :with-param name="unNodeSet" select=". //*"/> 
<xsl iwith-param name="soinme-courante" select="0"/> 
</xsl : call -tempi ate> 
</xsl :variable> 

Maison id = <xsl :value-of select="@id"/> 

Surface habitable = <xsl :value-of sel ect="$surface-habitabl e" />m2 /> 
</xsl :templ ate> 

<l -- ============================================================== --> 

<xsl itempl ate match="text( ) "/> 

</xsl :stylesheet> 

Resultat 

Maison id = 1 

Surface habitable = 136m2 /> 



Pattern n° 7- Fonction renvoyant plusieurs resultats 

Motivation 

II peut arriver, que dans une fonction un peu compliquee, on ait plusieurs resultats a 
renvoyer, qui sont intimement lies du point devuealgorithmique. Cela veutdirequesi 
I'on voulait renvoyer ces resultats un par un (un par appel), cela reviendrait a relancer 
plusieurs fois le meme calcul ou presque. Pour eviter cela, dans un langage comme C 
ou Java, on ecrit une fonction qui retourne une structure (C) ou un objet (Java). La 
question est done de voir comment ecrire en XSLT une fonction retournant (ou une 
action instanciant) I'equivalent d'une structure C. 

Realisation 

La solution est d'utiliser element source litteral a contenu calcule, instancie en TST 
(Temporary SourceTree, voir Temporary Source Tree, page 192) : 

Fonction renvoyant trois resultats x, y, z : 



Maison id = 2 
Surface habitable 



28m2 /> 



Maison id = 3 
Surface habitable 



57.5m2 /> 



<xsl itempl ate naine="truc"> 
<xsl iparam name=" . . . "/> 



Pattern n° 7 - Fonction renvoyant plusieurs resultats 




Chapitre 8 



<xsl :variable name="result"> 
<x> 

<xsl :val ue-of select^"..." /> 



</x> 

<y> 



<xsl :val ue-of select^"..." /> 



</y> 
<z> 



<xsl :val ue-of select^"..." /> 

</z> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl itempl ate> 
<xsl : tempi ate match^" . . . "> 

<xsl :variable name="a"> 

<xsl :cal 1 -tempi ate name="truc"> 

<xsl :with-param name^"..." sel ect=" . . . "/> 

</xsl :call-template> 
</xsl :variable> 

<xsl :val ue-of select="$a/x"/> 
<xsl :val ue-of sel ect="$a/y"/> 
<xsl :val ue-of sel ect="$a/z"/> 

</xsl :templ ate> 



On veut ici une fonction capable de detecter le premier separateur d'une chalne de carac- 
teres, et de decouper cette cliaine en trois morceaux : la partie situee avant le separateur, 
le Separateur lui-meme, et la partie situee apres le separateur. On suppose qu'il y a deux 
separateurs possibles : I'espace, et I'apostrophe. 

C'est pour celaqu'ondoitecrire une fonction : s'il n'y avaitqu'un seul separateur a conside- 

rer, on pourraitutiliser lesfonctions predefinies substrlng-beforeO et substring-after( ), 

Nous allons ici reutiliser la fonction index-of vue a la section Exemple, page 397 pour 
obtenir I'index de chacun des deux separateurs possibles ; le reste vient sans difficulte. 

separateurs.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding=' ISO-8859-r /> 



Exemple 



<xsl itemplate name="index-of "> 
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<xsl:parani name="aString"/> 
<xsl:parani nanie="testString"/> 

<xsl ivariable name="result"> 
<xsl :choose> 

<xsl :when test=" contains( SaString, $testString ) "> 
<xsl ivariable naine="string-Before"> 
<xsl :value-of 

select="substring-before( $aString, $testString )" /> 
</xsl :variable> 

<xsl :value-of select="l+string-length( $string-Before )" /> 
</xsl :when> 

<xsl :otherwise> 

-1 

</xsl :otherwise> 
</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl itempl ate> 

<xsl :templ ate naine="spl it-beforeAndAfter-f i rstSeparator"> 
<!-- separator = apostrophe ou espace --> 

<xsl : pa ram nanie="stringToSpl it"/> 

<!-- stringToSpl it is space-normalized --> 

<xsl :variable naine="indexOf-fi rstApos"> 
<xsl : call -tempi ate name="index-of "> 

<xsl :with-param name="aString" sel ect="$stringToSpl it"/> 
<xsl :with-param name="testString" select='"&apos;"'/> 
</xsl :call-template> 
</xsl :variable> 

<xsl rvariable name="indexOf-firstSpace"> 
<xsl :call-template name="index-of "> 

<xsl :with-param name="aString" select="$stringToSplit"/> 
<xsl :with-param name="testString" select='" "'/> 
</xsl :call-template> 
</xsl :variable> 

<xsl rvariable name="result"> 
<xsl :choose> 

<! > 

<xsl iwhen test=" $1ndexOf-firstApos < $indexOf-fi rstSpace "> 
<before> 

<xsl :value-of select="substring( $str1ngToSpl1t, 1, 
$indexOf-fi rstApos - 1 )" /> 

</before> 

<separator>' </separator> 
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<after> 

<xsl :val ue-of select="substring( $stringToSplit, 

SindexOf-firstApos +!)"/> 

</after> 
</xsl :when> 

<! > 

<xsl :when test=" SindexOf-firstSpace < SindexOf-firstApos "> 
<before> 

<xsl :value-of select="substring( 

$stringToSpl it, 1, 
$indexOf-fi rstSpace - 1 )" /> 

</before> 

<separator><xsl :text> </xsl :text></separator> 
<after> 

<xsl :val ue-of select="substring( 

SstringToSpl it, 

$indexOf-fi rstSpace +!)"/> 

</after> 
</xsl :when> 

</xsl :choose> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl itempl ate> 

<xsl ivariable name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de I'energie ! 
</xsl :variable> 

<xsl :variable name="pendule"> 

L'heure exacte. 
</xsl :variable> 

<xsl : tempi ate match="/"> 

<xsl ivariable name="spl itl"> 

<xsl :cal 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl :with-param name="stringToSplit" 
sel ect="normal ize-space($compl ainteDuCharretier) "/> 
</xsl :call-template> 
</xsl :variable> 

<xsl :val ue-of sel ect=" normal ize-space($complainteDuCharretier)"/> 
before = <xsl :value-of select="$spl itl/before"/> 
separator = "<xsl :val ue-of select="$spl itl/separator"/>" 
after = <xsl :val ue-of sel ect="$spl itl/after"/> 

<xsl :variable name="spl it2"> 

<xsl real 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl :with-param name="stringToSplit" 
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sel ect=" normal ize-spaceC$pendul e)"/> 
</xsl :call-teniplate> 
</xsl :variable> 

<xsl :text> 

</xsl :text> 

<xsl :value-of select="nornialize-space($penclule)"/> 
before = <xsl :value-Df select="$split2/before"/> 
separator = "<xsl :value-of sel ect="$spl it2/separator"/>" 
after = <xsl :value-of select="$spl it2/after"/> 

</xsl :template> 

<xsl itemplate match="text( ) "/> 
</xsl :stylesheet> 
Resultat 

Pousser des charettes a longueur de journee reclame de I'energie ! 
before = Pousser 
separator = " " 

after = des charettes a longueur de journee reclame de I'energie ! 

L'heure exacte. 

before = L 
separator = "'" 
after = heure exacte. 



Pattern n° 8 - Utilisation d'une structure de donnees auxilaire 

Motivation 

XSLT est un langagedont la description ne fait jamais appel defagon evidentea la notion 
de structure de donnees manipulable par telle ou telle instruction. En Java ou d'autres 
langages, 11 y a toujourstoute une panopliede structures possibles (tableaux, listes, piles, 
etc.), maispas en XSLT. 

X SLT ne connait que la notion d'arbre XML; done, en acceptant la structure d'arbre comme 
structure de donnees universelle, on peut se raccrocher aux branches, et par\/enir a ses fins. 

En effet, un arbreXM L, en tantqueTST accroche a une variable peutjouer le role d'une 
structure de donnees (non modifiable, comme d'habitude en XSLT) : une fois I'arbre 
construit dans une variable, on peut utiliser des expressions X Path pour le parcourir et 
extraire les informations utiles. Et si cet arbreX M L est un peu trop volumineux ou com- 
plexe pour que les recherches y soient efficaces, rien n'empeche d'y indexer certaines 
valeurs par une cle (xsi : key). 
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Exemple 



Dans cet exemple, nous allons montrer comment mettre en oeuvre une structure de don- 
nees indispensable au traitement. II s'agit de renumeroter sequentiellement des identi- 
fiants numeriques de pages d'une presentation video-projetable specifiee en XM L, Un 
exemple abrege d'un tel fichierXML pourraitetre celui-ci : 

presentation.xml 

<?xml version="1.0" encoding="UTF-16" ?> 

<presentation> 

<pageDeTitre id="CoursXML.l" next="CoursXML.2"> 

<titrePresentation>Coinprendre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML.l" next="CoursXML.3"> 
<titre level="l" id="CoursXML.2.Deroulement"> 
Deroulement du Cours</titre> 

</pageStandard> 



<plan id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.4.1"> 

<titre level="l" id="CoursXML.4. XMLgeneral"> 

XML - Generalites </titre> 

</pageStandard> 



<pageStandard id="CoursXML.4.1" prev="CoursXML.4" next="CoursXML.4.2"> 

<titre level="2" id="CoursXML.4.1. Langagesdebalisage"> 

Les langages de balisage </titre> 

<bloc> 

<figure src="ArbreXML_l" id="fig:ArbreXML_l.CoursXML.4.1"> 

<captionFigure> 

Structure arborescente d'un document XML bien forme 

</captionFigure> 
</figure> 
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</bloc> 
</pageStandard> 



<pageStandard id="CoursXML.4.2" prev="CoursXML.4. 1" next="CoursXML.5"> 
<titre level="2" id="CoursXML.4.2._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 

</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4.2" next="CoursXML.6"> 

<titre level="l" id="CoLirsXML.5. StructuredocuinentXML"> 

Structure d'un document XML </titre> 



<bloc> 

Ces blocs juxtaposes ou imbriques torment un arbre 
<cf Figure cf="fig:ArbreXML_l.CoursXML.4.1"/> 
comme tout document XML. 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.6" prev="CoursXML. 5" next="CoursXML.7"> 
<titre level="2" id="CoursXML.6._DTD"> 
Grammaire d'un document XML (DTD) 
</titre> 

</pageStandard> 

<pageFin id^ToursXML.?" prev="CoursXML. 6" /> 
</presentation> 

De temps en temps, on ajouteou suppri me des pages entre deux, cequi fait que lesnume- 
ros d'identifiant des pages finissent par etre assez eloignes de I'ordre naturel. La renu- 
merotation consiste a retablir I'ordre naturel, sachant qu'il y a des repercussions sur 
d'autres identifiants, comme ceux des titres, ou des figures, et par vole de consequence, 
les references aux figures, 

Le resu I tat attend u de la transformation XSLT est done celui-ci : 

presentation -new .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
i <presentation> 

I <pageDeTitre id="CoursXML.l" next="CoursXML.2"> 
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<titrePresentation>Comprendre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML. 1" next="CoursXML.3"> 
<titre level="l" id="CoursXML.2._"> 
Deroulement du Cours</titre> 

</pageStandard> 



<plan id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.5"> 

<titre level="l" id="CoursXML.4. XMLgeneral"> 

XML - Generalites </titre> 

</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4" next="CoursXML.6"> 

<titre level="2" id="CoursXML.5. Langagesdebal isage"> 

Les langages de balisage </titre> 

<bloc> 

<figure src="@src" id="fig:ArbreXML_l.CoursXML.5"> 
<captionFigure> 

Structure arborescente d'un document XML bien forme 
</captionFigure> 
</figure> 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.6" prev="CoursXML.5" next="CoursXML.7"> 
<titre level="2" id="CoursXML.6._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 

</pageStandard> 



<pageStandard id="CoursXML.7" prev="CoursXML. 6" next="CoursXML.8"> 
<titre level="l" id="CoursXML.7. StructuredocumentXML"> 
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Structure d'un document XML </titre> 



<bloc> 

Ces blocs juxtaposes ou imbriques forment un arbre 
<cf Figure cf="fig:ArbreXML_l.CoursXML.5"/> 
comme tout document XML. 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.8" prev="CoursXML.7" next="CoursXML.9"> 
<titre level="2" id="CoursXML.8._DTD"> 
Grammaire d'un document XML (DTD) 
</titre> 

</pageStandard> 

<pageFin id^ToursXML.?" prev="CoursXML. 6"/> 



</presentation> 

Le probleme est done ici de garder en memoire une table de correspondance entre les 
anciens id et les nouveaux.Ayant une telle table, a chaquefois qu'on a un id a changer, 
on va chercher le nouvel id correspondant a I'ancien, ce qui nous permet de former une 
nouvellechainedecaracteresa parti r de ce nouvel id, 

Par exemple, ayant I'identifiant fig:ArbreXML_i.coursXML.4.i, on en extrait cours- 
XML.4.1 ; la talDle nous donne la correspondance de cet identifiant avec 5, ce qui nous 
permet de former I'identifiant "fig:ArbreXML_i.coursXML.5". 

De meme, a parti r de coursXML.4 . i, on obtient a nouveau 5, done a partir de 5+1 et de 5-1, 
on forme respectivement les identifiants next (coursXML.e) et prev (coursXML.4). 

La realisation de cette table consiste a creer un arbre XM L contenant toutes les paires 
(ancien id , nouvel id) conservees par exemple en tant qu'attributs d'un element 
<page> qui sera repete autantdefois qu'il y adepagesdeclareesdansia <presentation> 

(ce qui inclut toutes les SOrteS de pages: <pageDeTitre>, <plan>, <pageStandard>, 
<pageFi n>). 

On peut done faire cela de cette maniere : 

Constitution de la table de correspondance 

<xsl :variable name="lesPages"> 
<pages> 

<xsl :for-each select="/presentation/*"> 
<page> 

<xsl :attribute name="id"><xsl :value-of select="@id"/></xsl :attribute> 
<xsl :attribute name=''newld"> 
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<xsl :value-of select="positionC)"/> 
</xsl :attribute> 
</page> 
</xsl :for-each> 
</pages> 
</xsl :variable> 

Cette variable sera une variable globale, ce qui veut dire qu'elle sera evaluee avec le 
noeud racinecommenoeud contexte; avec lefichier presentation. xmi montre ci-dessus, 
I'arbre genere sera lesuivant: 

Arbre genere lors de 1 'evaluation de cette variable 

<pages> 

<page id="CoursXML.l" newld="r7> 
<page icl="CoursXML.2" newId="2"/> 
<page id="CoursXML.3" newId="3"/> 
<page id="CoursXML.4" newId="4"/> 
<page id="CoursXML.4.1" newId="5"/> 
<page id="CoursXML.4.2" newId="6"/> 
<page id="CoursXML.5" newId="7"/> 
<page id="CoursXML.6" newId="8"/> 
<page id="CoursXML.7" newId="9"/> 
<pages> 

On peut tout de suite mettre au point un modele nomme qui permettra d'instancier le 
newiD connaissant I'id : 



Arbre genere lors de 1 'evaluation de cette variable 

<xsl rtemplate name='instancier-newID'> 
<xsl:parain naine='oldId'/> 
<xsl :value-of sel ect="$l esPages/pages/page[ 

attribute: :id = Soldid 
]/attribute: :newld" /> 

</xsl itempl ate> 



Remarque 

On utilise ici le faitqu'une variable contenantunTST est implicitement convertie en node-set lorsqu'elle estrefe- 
rencee. On rappelle que ceci n'estpas conforme au standard XSLT 1.0, mais que c'estune proposition qui sera 
selon toute vraisemblance integree au standard XSLT 2,0. Voir a ce sujet la section Operations sur un TST 
(XSLT 1.1 ou plus), page 198. 



Ceci etant, on quitte maintenant le domaine du pattern pour entrer dans le specifique, 
puisqu'il s'agit de realiser la transformation demandee (le pattern ne concerne que la 
fafon de realiser une structure de donnees). M ais en fait, si on quitte le domaine du pat- 
tern, c'est pour y revenir aussitot, car ce qu'on a a faire maintenant est une copie presque 
conforme du document (pour s'en convaincre, 11 suffitde comparer le document source et 
le resultat attendu : au premier coup d'oeil, on ne volt pas de difference, car seules les 
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parties numeriques des identifiants changent d'un document a I'autre). Or une copie 
presque conforme, c'est un des patterns de transformation, que nous verrons done dans le 
cliapitrequi leur estconsacre. 

Si I 'on s'interesse dans un premier temps uniquement a la fagon de modifier les attributs 
d'une <pagestandard>, on va commencer par ecrire une regie qui expioite cette tabie de 
correspondanceen utiiisant ie modeie nomme instancier-newio : 

Modification des attributs d'une pageStandard 



<xsl :template match=' pageStandard '> 
<pageStandard> 

<xsl ivariable naine="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 

<xsl iwith-param naiiie='oldId' select="@id" /> 
</xsl :call-template> 
</xsl :variable> 

<xsl :attribute name="id">CoursXML.<xsl :val ue-of sel ect="$NoSeq" /> 
</xsl :attribute> 

<xsl :attribute name="prev">CoursXML.<xsl :value-of sel ect="$NoSeq - l"/> 
</xsl :attribute> 

<xsl lattribute nanie="next">CoursXML.<xsl :value-of sel ect="$NoSeq + !"/> 
</xsl :attribute> 

</pageStandard> 
</xsl itempl ate> 

On aura exactement ie meme traitement pour ia page speciaie <pi an>, et des regies voisines 
pour une <pageDeTi tre> et une <pageFi n>, ce qui nous amene a ceci : 



Modification des attributs d'une pageStandard ou d'un plan 

<xsl :template match^'pageStandard | plan'> 
<xsl :el ement name="{ local -nameC . ) }"> 
<xsl ivariable naine="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 

<xsl :with-param name='oldId' select="@id" /> 
</xsl :cal 1 -tempi ate> 
</xsl :variable> 

<xsl lattribute name="id">CoursXML.<xsl :val ue-of sel ect="$NoSeq" /> 
</xsl :attribute> 

<xsl lattribute name="prev">CoursXML.<xsl :value-of sel ect="$NoSeq - !"/> 
</xsl :attribute> 

<xsl lattribute name="next">CoursXML.<xsl :value-of sel ect="$NoSeq + !"/> 
</xsl :attribute> 



<xsl :apply-templates/> 
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I</xsl :el ement> 
</xsl itempl ate> 

Modification des attributs d'une pagePeTitre 

<xsl itemplate niatch='pageDeT1tre'> 

<!-- Idem sans I'attribut prev --> 
</xsl itempl ate> 

Modification des attributs d'une pageFin 

<xsl itemplate niatch='pageDeT1tre'> 

<!-- Idem sans I'attribut next --> 
</xsl itempl ate> 

M aisil nesuffit pas derecopierune page (i.e. un element du genre page) en secontentant 
de generer des attributs modifies: encore faut-il copier ses enfants directs comme 
<titre> ou <bioc>, ce qui pourra etre fait par des regies dediees a cliacun de ces ele- 
ments. C'est pourquoi ie modele de transformation se termine par un <xsi:appiy- 
tempiates/>, Qui va reiancer ies regies concernees. 

Mise en place de regies specifiques pour les enfants d'une page 

<xsl:template match='titre'> 
<titre> 

</titre> 
</xsl itempl ate> 

<xsl itemplate match='figure'> 
<figure src="@src''> 

</figure> 
</xsl itempl ate> 

<xsl itemplate match='cfFigure'> 
<cf Figure> 

</cf Figure> 
</xsl itempl ate> 

Dans ciiacune de ces regies, on effectue un traitement simiiaire a celui d'une page pour 
former et generer ies nouveiies vaieurs d'attributs identifiants. 

Le probieme est maintenant de voir comment i'ensembie s'articule. Le processus de 
traitement demarre sur la racine, pour iaqueiie aucune regie n'est prevue. La regie par 
defaut va done s'appiiquer, ce qui va produire un node-set ne contenant que i'eiement 
<presentation>, et reiancer toute ia mecanique sur ce node-set. A nouveau, ia regie 
par defaut sera selectionnee, car ii n'y a aucune regie specifique pour une <presenta- 
tion>. M ais cette fois, ce n'est pas souiiaitabie, car i'eiement <presentation> ne peut 
pas etre traite par defaut: ii faut ie recopier. Pius generaiement tout element pour 
iequei une regie specifique n'existe pas (typiquement, il s'agit des elements qui n'ont 
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pas d'attributs concernes par la renumerotation, ou pas d'attribut du tout) doit etre 
traite non pas par defaut, mais par une regie qui va le recopier sans modification. II faut 
done avoir une regie « ramasse-tout » de recopie (pour des explications comple- 
mentaires concernant cette regie, voir le pattern « Copie non conforme », a la section 
Pattern n° 10 - Copie non conforme, page 443) : 

Regie de recopie ratnasse-tout 

<xsl :templ ate match='*'> 
<xsl :copy> 

<xsl lapply-templates sel ect='@*| node( ) ' /> 
</xsl :copy> 
</xsl itempl ate> 

Void done maintenant le programme complet : 

renutneroter.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" 

version = "!.!"> <!-- compatibilite Saxon 6.5 --> 



<xsl:output method^'xml ' encodings' ISO-8859-r /> 



<xsl ivariable naine="lesPages"> 
<pages> 

<xsl :for-each select="/presentation/*"> 
<page> 

<xsl :attribute nanie="id"><xsl :val ue-of select="@id"/> 
</xsl :attribute> 

<xsl :attribute name="newld"><xsl :value-of select="position( )"/> 

</xsl :attribute> 

</page> 
</xsl :for-each> 
</pages> 



</xsl :variable> 



<xsl itemplate naine=' instancier-newID'> 
<xsl:parain nanie='oldId'/> 
<xsl :value-of select="$lesPages/pages/page[ 

attribute: :id = $oldId 
]/attribute: :newld" /> 

</xsl :templ ate> 

<xsl :templ ate match^'pageStandard | plan'> 
<xsl :el ement name=" {local -naine( . ) } "> 
<xsl : vari abl e name="NoSeq"> 

<xsl :call-template nanie='instancier-newID'> 
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<xsl iwith-param name^'oldld' sel ect="@id" /> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl :attribute naine="id">CoursXML.<xsl :value-of 

sel ect="$NoSeq" /></xsl :attribute> 
<xsl :attribute naine="prev">CoursXML.<xsl :value-of 

sel ect="$NoSeq - I'VX/xsl :attribute> 
<xsl :attribute naine="next">CoursXML.<xsl :value-of 

sel ect="$NoSeq + 1" /X/xsl :attribute> 

<xsl :apply-teinplates/> 
</xsl :el einent> 
</xsl itempl ate> 

<xsl itemplate niatch='pageDeTitre'> 

<xsl :el ement name=" {1 ocal -name( . ) )"> 
<xsl :variable name="NoSeq"> 

<xsl icall-template naine='instancier-newID'> 

<xsl iwith-param name^'oldld' select="@id" /> 
</xsl : cal 1 -tempi ate> 
</xsl :variable> 

<xsl : attribute name="id">CoursXML.<xsl :val ue-of 

sel ect="$NoSeq" /X/xsl :attribute> 
<xsl lattribute name="next">CoursXML.<xsl :value-of 

sel ect="$NoSeq + 1" /X/xsl :attribute> 

<xsl :apply-templates/> 
</xsl :el ement> 
</xsl :templ ate> 

<xsl :template match='pageFin'> 

<xsl : el ement name=" {local -name( . ) )"> 
<xsl :variable name="NoSeq"> 

<xsl :cal 1 -tempi ate name='instancier-newID'> 

<xsl iwith-param name^'oldld' select="@id" /> 
</xsl :call-template> 
</xsl :variable> 

<xsl : attribute name="id">CoursXML.<xsl :val ue-of 

sel ect="$NoSeq" /X/xsl :attr1bute> 
<xsl :attribute name="prev">CoursXML.<xsl :value-of 

sel ect="$NoSeq - 1" /X/xsl :attr1bute> 

</xsl :el ement> 
</xsl :templ ate> 

<xsl :template match='titre'> 



<titre> 
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<xsl :variable naine="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 
<xsl iwith-param name='oldId' 

select="parent: ipageStandard/attribute: :id" /> 
</xsl : call -tempi ate> 
</xsl :variable> 



<xsl ivariable name="texteID" select='substring-after(@id. 

<xsl :attribute name="l evel "> 

<xsl :value-of select="@level " /> 
</xsl :attribute> 

<xsl :attribute name="id"> 

<xsl :text>CoursXML.</xsl :text> 

<xsl :value-of select="$NoSeq" /> 

<xsl :text>. </xsl :text> 

<xsl :val ue-of select="$texteID" /> 
</xsl :attribute> 

<xsl :apply-templates/> 



_")■/> 



</titre> 
</xsl :templ ate> 



<xsl itempl ate match='figure'> 

<figure src="@src"> 

<xsl : vari abl e name="NoSeq"> 

<xsl icall-template name='instancier-newID'> 
<xsl :with-param name^'oldld' 

sel ect="ancestor: :pageStandard/attribute: :id"/> 
</xsl :call-template> 
</xsl :variable> 

<xsl : vari abl e name="texteID" select='substring-before(@id, ".")' /> 

<xsl lattribute name="id"> 

<xsl :value-of select="$texteID" /> 

<xsl :text>.CoursXML.</xsl :text> 

<xsl :value-of select="$NoSeq" /> 
</xsl :attribute> 



<xsl :apply-templates/> 
</figure> 
</xsl itempl ate> 
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<xsl : tempi ate niatch='cfFigure'> 



<cf Figure> 

<xsl :variable name="NoSeq"> 

<xsl icall-template naine='instancier-newID'> 
<xsl iwith-param name^'oldld' 

select="substring-after(@cf , ' . ' )"/> 

</xsl : call -tempi ate> 
</xsl :variable> 



<xsl ivariable name="texteID" select='substring-before(@cf , ".")' /> 



<xsl :attribute name="cf"> 

<xsl :val ue-of sel ect="$texteID" /> 
<xsl :text>.CoursXML.</xsl :text> 
<xsl :val ue-of sel ect="$NoSeq" /> 
</xsl :attribute> 
</cf Figure> 
</xsl :templ ate> 



<xsl itemplate match='*'> 
<xsl :copy> 

<xsl :apply-templates select='@*|node( ) ' /> 
</xsl :copy> 
</xsl itempl ate> 



</xsl :stylesheet> 

Ce programme fonctionne avec Saxon, qui accepte les evolutions prevues dans le W3C 
Worl<ing Draft XSLT 1.1. Avec un processeur qui s'en tientau standard XSLT 1.0, il faut 
utiliser unefonction d'extension pour convertir explicitementen node-set I e RTF renvoye 
par la reference a la variable i esPages ; les modifications concernent la declaration de la 
feuille de style, et le modele nomme instanci er-newio. Le reste est inchange. 

Modifications pour utiliser la fonction d'extension nodeset 

<xs1 :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" 
xmlns:xalan="http://xml .apache.org/xalan" 
excl ude-resul t-pref ixes="xal an" 
version = "1.0"> 

<xsl itemplate name='instancier-newID'> 
<xsl:param name='oldId/> 

<xsl :value-of select="xalan:nodeset($lesPages)/pages/page[ 

attribute: :id = $oldId]/attribute: :newld" /> 

</xsl :templ ate> 

II pourraetre interessantderevenir a ce programme apres avoir vu le pattern « Copie non 
conforme », a la section Pattern n° 10 - Copie non conforme, page 443. 
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Pattern n° 9 - Identite de noeuds et node-set de valeurs 
toutes differentes 

Motivation 

II peut arriver que I'on ait a tester I'identite de deux noeuds pour savoir si ce sont les 
memes ou non. 

II y a alors deux choses a savoir : la premiere, c'est ce que signifie I'identite de deux 
noeuds, et comment une situation ou il y a identite peutseproduire ; la deuxieme, c'est de 
savoir comment s'y prendre pour real iser un tel test. 

M aisavantcela, 11 est indispensable, arrive a ce point, debien expliciter le rapport qu'il y 
a entre les node-sets que I'on manipule au travers d'expressions XPath et les noeuds 
qu'ilscontiennent. On se place dans lecassimpleou I'on a un arbreXM L (I'arbreXM L 
du document source), mais pas de variable attachee a un TST, ni de document XML 
secondaire accessible par la fonction documentc ), 

Supposons maintenant que nous ayons constitue deux node-sets, grace a deux expressions 
XPath quelconques, Quecontiennentexactement ces node-sets ? 

Certainement pas une copie des noeuds de I'arbre X M L, car le nombre de noeuds total 
dans le systeme ne varie pas au cours de I 'execution (tout au moins dans I'hypothese 
expliciteeci-dessus) : ce nombre est eel ui de I'arbresourceXM L. 

Sont-ce alors les noeuds originaux ? 

Pas plus, car cela voudrait dire que si un noeud etait contenu dans un certain node-set, il 
ne serait plus disponible pour faire parti e d'un autre node- set, ce qui est absurde. 

La reponse est d'ordre mathematique : en mathematiques, les ecritures comme x, y, N, 
designent des objets mathematiques qui peuplent I' uni vers mathematique, etqui existent 
chacun en un seul exemplaire. II n'y a pas plusieurs nombre un, il n'y en a qu'un ; mais 
11 y a une infinite d'ecritures designant ce nombre, parmi lesquelles, 1, 0-i-l, 2/2, x tel que 
x solution de I 'equation x = 1, y tel que y solution de I 'equation y = 1, etc. Avec les deux 
dernieres ecritures, on peut dire que x = y, parce que x et y sont deux ecritures qui 
designent le meme nombre (un, en I 'occurrence). 

La meilleure representation qu'on puisse se faire d'un node-set est basee sur la meme 
idee: un node-set contient des choses qui refe'rencent les noeuds del'arbreX ML source, 
mais pas les noeuds eux-memes, ni encore moins une copie. Cela s'implemente evidem- 
ment sous la forme de pointeurs, mais i I esta noter que I e standard XSLT ne pari e jamais 
de pointeurs, qui sont des notions d'implementation, et seraient plutot mal venues dans 
une specification. La figure 8-1 donne une representation graphique du lien entre un 
node-set et les noeuds qu'il contient. 

Imaginons maintenant que I'on veuille constituer un node-set contenant les surfaces des 
pieces du RDC (toujours en se reportant a la figure 8-1). 
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/maison/RDC/* [not (Ssurface) ] / /maison/RDC/bureau 



root- 

/ 




attribute -7 

\ surface / 
\ 40m2 / 



attribute 

\ surface 

\ 40m2 



text 




^ text ^ 


Evier inox. 




Lavabo. 


M obilier 




Cumulus 


encastre. 




200L. 



text 

Cheminee en 

pierre. 
Poutres au 
plafond. 
Carrel age terra 

cuite. 
Grande bale 
vitree 



attribute 

surface 

15m2 



— text — 

Bibliotheque 
encastree. 



Figure 8-1 

Deux node-sets partageant un naud commun. 



On pourraitetretente d'ecrire : 
Node-set des surfaces 

I <xsl :variable name="x" select="/maison/RDC/*/attribute: :surface"/> 

Ce qui n'est pas forcement faux, M ais est-ce bien ce qu'on voulait ? Si le but etait d'obte- 
nir un node-set ne contenant que des surfaces differentes les unes des autres (apres tout, 
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un ensemble ne contient bien que des elements differents les uns des autres, non ?), c'est 
rate. Le node-set $x contient trois elements, correspondant aux surfaces 40m2, 40m2, 
ISml Mors? Quese passe-t-il ? 

C'est tres simple a voir graphiquement (voir figure 8-2). 



/inaison/RDC/*/attribute : : surface 





attribute 

surface 

40m2 



1 — text — 




- text ^ 


Evier inox. 




Lavabo. 


M obilier 




Cumulus 


encastre. 




200L. 



text 

Cheminee en 

pierre. 
Poutres au 
plafond. 
Carrelageterre 

cuite. 
Grande bale 
vitree 



— text — 

Bibliotheque 
encastree. 



Figure 8-2 

Un node-set d'attributs. 
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Le node-set ainsi constitue a bien trois elements, parce qu'il y a bien trois attributs dans 
I'arbre XML. Que deux d'entre eux aient la meme valeur textuelle ne change rien a 
I'affaire : 11 y a trois attributs, et rien ne peut detruire cette certitude. 

Nous avons done repondu a la premiere question, qui etait de savoir ce qu'est la notion 
d'identite : deux noeuds d'un node-set sont identiques s'ils referencent le meme noeud de 
I'arbreXML. 

M ais la deuxieme question reste en suspens : comment faire pour tester I'identite de deux 
noeuds ? Et nous venons d'ajouter une question supplemental re : comment faire pour consti- 
tuerun node-sets de surfaces, c'est-a-direun node-set de noeuds de valeurs toutes differentes? 

C 'est ce que nous al Ions vol r maintenant. 

Realisation 

Tests d'identite 

II n'y a que deux moyens de realiser un test d'identite en XSLT : soit on emploie I'ope- 
rateur - j - (barre verticale) qui realise I'union ensembliste de deux node-sets, soit on 
utilise la fonction predefinie generate-id( ), qui comme son nom I'indique, retourne 
un identifiant pour le noeud qui lui est transmis (explicitement, ou implicitement si 
c'est le noeud contexte). 

Pour simplifier et se concentrer sur le principe, on peut supposer que le test d'identite va 
s'appliquer a deux node-sets NSl (ne contenant qu'un seul noeud nl) et NS2 (ne conte- 
nant qu'un seul noeud n2). Le test d'identite des noeuds nl et n2 peut alors etre applique 
aux node-sets NSl et NS2, chose indispensable en XSLT puisqu'on ne peut manipuler 
que des node-sets. 

Tests d'identite 

j count( $NS1 I $NS2 ) = 1 

' generate-1d( $NS1 ) = generate-id( $NS2 ) 

Le deuxieme test est direct : generate-ido renvoie un identifiant sur le premier noeud du 
node-set qui lui est transmis; la specification de cette fonction garantit que si lesidentifiants 
sont egaux (en tant que chaines de caracteres), alors I es noeuds transmis sont confondus. 

L e premier test est un peu plustordu, mais constitue une expression X Path idiomatique : 
si NSl etNS2, deux singletons, ontunereunion dontle cardinal reste egal a 1, c'est qu'ils 
contiennent I e meme element (au sens de I'identite que nous avons vu plus haut), c'est-a- 
dire qu'ils partagent le meme element (voir figure 8-1 ). 

Dans la meme veine, on a le test d'appartenance vu a la section Appartenance et test 
d 'inclusion, page 44 ($N represente un node-set ne contenant que le noeud dont I'appar- 
tenance a $N S est a tester) : 



Tests d'appartenance 

I count( $N I $NS ) = count( $NS ) 
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Node-set de valeurs toutes differentes 

Methode du preceding-sibling 

Pour le node-set de surfaces, c'est un peu plus complique. En toute logique, il fau- 
drait exprimer le node-set sous forme d'une expression X Path qui dise quelque chose 
du genre : 

I/maison/RDC/*/attribute: : surf ace [ 
la valeur textuelle de . n'existe pas deja dans le node-set en construction 

Remarque 

Ne pas oublierque dans cette expression, le « . » represente le noeud contextede revaluation du predicat : c'est 
done tour a tour chacun des nceuds de I'ensemble /niaison/RDC/*/attribute: : surface, Pour chacun de ces 
noeuds, on teste si sa valeur textuelle etc., etc. : si oui, on garde le nceud dans le node-set en construction, 
sinon, on le rejette. 

M alheureusement, une telle expression n'est pas traduisible en X Path, parce qu'il n'y 
a aucun moyen de referencer le node-set en cours de construction. II faut contourner 
le probleme en trouvant une fagon de dire la meme chose sans parler de node-set en 
construction : 

/inaison/RDC/*/attribute: : surf ace [ 

la valeur textuelle de . n'existe pas deja dans un certain node-set NS 

] 

Cette expression est cette fois traduisible en XPath, mais le probleme reste entier : com- 
ment trouver le node-set NS ? En tri chant un peu, on peutarriver a en trouver un. En effet 
les noeuds portant les attributs surface sonttous des enfants d'un element unique <rdc> 
(si tant est qu'il n'y ait pas plusieurs rez-de-chaussee dans une mememaison, et qu'il n'y 
ait pas plusieurs elements <maison> accroches a la racine). 

Done dans devaluation du predicat ci-dessus, le noeud contexte se deplace de proche en 
proche sur des noeuds surface qui sont portes par des elements de I'axe child: :*, done 
des elements qui sont selectionne's dans I 'ordre de lecture du document. 

La solution qu'on peut alors tenter de mettre en ceuvre decoule de la remarque suivante : 
puisque les elements sont selectionnes dans I 'ordre de lecture du document, les elements 
dejfl traites dans I'evaluation du predicat sont ceux qui se trouvent dans le node-set 
preceding-sibling: :* relatif a I'element en cours de test, Avec cette idee, la pseudo- 
expression X Path ci-dessus devient : 

I/ma1son/RDC/*[ la valeur textuelle de ./attribute: :surface n'existe pas deja dans 
preceding-si bl ing: :*/attr1bute: : surface ] /attribute: : surface 

Ce qui donne, en bon X Path : 

Creation d'un node-set de surfaces toutes differentes 



I /ma1son/RDC/*[ not( ./©surface = preceding-sibl ing: :*/@surface ) ]/@surface 
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La encore, cette expression, quoiqu'un peu complexe, est assez idiomatique. On la 
retrouve sous diverses formes, notamment dans les transformations XSLT comportant 
des regroupements (voir Pattern n° 14 - Regroupements, page 474). 

A cliaque fois, on exploite la propriete selon laquelle un element se trouvant dans 
preceding-sibi ing: :* se trouve aussi necessai rement dans le node-set en cours de 
construction, ce qui donne une approximation du node- set en cours de construction, 

A noter que la construction d'un node-set d'au plus n elements, avec ce genre de predi- 
cat, est une operation pouvant demander n(n-l)/2 comparaisons dans les cas les moins 
favorables, parce que plus on avance, plus il y a du mondederriere, et done plus I'explo- 
ration de preceding-sibling: :* est longue. 

Methode du regroupement parcle 

U ne autre methode existe pour etablir un tel node-set. Cette methode a ete inventee par 
Steve M uench, de la societe Oracle (quelqu'un de tres actif dans le domaine de XSLT), 
L'idee est de partir de node-sets obtenus par la fonction keyo, appliquee a une cle 
regroupant les valeurs identiques, comme indique sur la figure 8-3. 

Si, dans la situation schematisee par la figure 8-3, on appelle la fonction keyo avec 
« 40m2» comme deuxieme argument, on obtient en retour un node-set d'attributs dont 
lesvaleurstextuellessonttoutesegalesa« 40m2» ; deplusil est certain quecegroupede 
surfaces contient toutes les surfaces de« 40m2» (il n'en manque aucune). 

Pour obtenir le node-set des surfaces toutes differentes, il suffit done de prendre un et 
un seul noeud dans chaque groupe de surfaces, c'est-a-dire le premier noeud de chaque 
groupe (s'il y a un premier, pourquoi pas lui ? et s'il n'y en a pas, c'est que le groupe 
est vide). 

On part done d'une declaration de cle, comme ceci : 

<xsl :key name="groupesdeSurfacesParValeurs" 
match="attribute: isurface" 
use="." /> 

Ensuite, on veut recolter des surfaces ; on va done ecrire : 

I //attribute: isurface 

ce qui recolte toutes les surfaces. Un noeud attribute de ce node-set ne doit etre garde 
que s'il s'identifieau premier noeud attribute renvoye par : 

I key( 'groupesdeSurfacesParValeurs' , la valeur textuelle du nsud teste) 

Or la valeur textuelle du noeud teste est tout simplement la valeur textuelle de "." , 
puisqu'on est en train d'etablir un predicat : 

I key( 'groupesdeSurfacesParValeurs' , .) 

Le premier noeud du node-set renvoye par cette expression est done : 

I key( 'groupesdeSurfacesParValeurs' , .)[1] 
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attribute 

\ surface / 

\ 40m2 / 



1 — text — 




- text ^ 


Evier inox. 




Lavabo. 


M obilier 




Cumulus 


encastre. 




200L. 



attribute 

surface 

\ 40m2 



text 

Cheminee en 

pierre. 
Poutres au 
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element - 

^ garage 



attribute 

surface / 

, 15m2 / 



— text — 

Bibliotheque 
encastree. 



Figure 8-3 

Regroupement de valeurs par c\e. 
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Ce qui donne un predicat de la forme : 

//attribute: :surface[ 

. s'identifie a ( key( 'groupesdeSurfacesParValeurs' , ) 

] 

On est done maintenant ramene a un probleme d'identification (ou de test d'identite), 
probleme que I'on sait resoudre (voir ci-dessus) ; nous clioisissons ici la metliode par 

appel de la fonction generate-id( ) : 

Creation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-1d( ) = 
generate-1d( 

key( 'groupesdeSurfacesParValeurs' , . )[1] 

) 

] 
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Patterns de transformation 



Les patterns de transformation, a I 'inverse des patterns de programmation, constituent 
des buts en soi. Ceci ne veut pas dire qu'une feuille de style n'aura jamais d'autre but 
quecelui misen oeuvreau traversdu pattern, maisplutotqu'unefeuilledestylequi ne 
mettrait en oeuvre qu'un de ces patterns pourrait tout de meme faire quelque cliose de 
sense. 

Comme pour les patterns de programmation, il ne s'agit pas ici de constituer un catalo- 
gue exhaustif. 1 1 est meme probable que la mise en evidence de nouveaux patterns se fera 
plus pour des patterns de transformation que pour des patterns de programmation. 

Pattern n° 10 - Copie non conforme 

Motivation 

N ous avons donne beaucoup d'exemples (voir S<?mantique, page 325) de I'utilisation de 
I'instruction xsi :copy, mais peut-etre avez vous pense qu'ils n'etaient pasforcementtres 
utiles dans la pratique. En effet, a quoi sert de recopier a I'identique un document XM L 
vers un autre ? 

En fait, cela n'estpassi inutile que cela, caravec xsi :copy, il est possible dereglerfine- 
ment le moment ou la copie s'arrete pour laisser place a la variante. II est ainsi possible 
d'obtenir une copie d'un fragment XM L, qui n'est pasexactement identique a I 'original, 
mais legerement differente. 

Par ailleurs, si nous avons donne beaucoup d'exemples, c'etait pour illustrer les diffe- 
rents cas possibles de comportement de I'instruction xsi :copy en fonction du type de 
noeud courant. M ais il est possible d'ecrire une copie generique, qui marche dans tous les 
cas. 
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Done, avant de voir une copie non conforme, voyons tout d'abord une copie conforme 
generique. II evident, par ailleurs, qu'une copie conforme se fait tres simplement avec 
xsi :copy-of ; mais pour evoluer vers une copie non conforme, il faut partir d'une copie 
conforme utilisant xsl:copyetnon pas xsl : copy -of. 

Ensuite nous verrons I'interet qu'il peuty avoir a obtenir un document presque identique 
a I 'original, et comment realiser eel a, 

Copie conforme generique 

Commengons par considerer la regie suivante : 

<xsl :templ ate match="*"> 

<xsl :copy> 

<xsl :apply-teniplates/> 

</xsl :copy> 
</xsl itempl ate> 

C'est une regie recursive, puisque elle s'applique a tout element, et qu'elle sera done 
selectionnee pour traiter les noeuds rassembles en une nouvelle liste par <xsi :appiy- 

tettipl ates/>. 

Une des premieres choses dont il faut done s'inquieter, c'est de savoir si la recursion a 
des chances de s'arreter, ou si elle est infinie. Clairement, la recursion s'arrete si la liste 
de noeuds constituee par <xsi :appiy-tempiates/> est vide. Cela peut-il se produire? 
Oui, puisque les noeuds en question sont les enfants directs du noeud courant, Si done le 
noeud courant estunefeuilledel'arbreXM L, la recursion s'arrete. 

La regie montree ci dessus exprimedonc la definition recursive suivante : 

La recopie d'un element, c'est : 

la copie de cet element 

a laquelle on accroche : 

- la recopie du premier enfant 

- la recopie du deuxieme, 

- la recopie du dernier enfant, 

- ou rien s'il n'y a pas d'enfant. 

Cecl constitue done I 'idee de base pour realiser une copie conforme et en profondeur d'un 
element, M aisce n'est pas suffisant, car I'element peut avoir des attributs, qui dans la regie 
ci-dessus, sont ignores. Comme en XM L, un attribut n'est pas un enfant, les attributs ne 
sont done pas pris en compte par cette regie. 

M ais il suffit d'y penser, et dedemander la recopie des attributs : 

La recopie d'un element, c'est : 

I la copie de cet element 

I a laquelle on accroche : 
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I- la recopie des attributs s'il y en a, 
- la recopie des enfants s'il y en a. 

M ais du coup, si I'on fait 9a, la regie est incompiete, car on y demande la recopie des 
attributs, alors qu'on definit la recopie d'element, mais pas celle d'attribut, La encore, 
c'esttres simple de corriger : 

la recopie d'un element ou d'un attribut, c'est : 

la copie de cet element ou de cet attribut 
a laquelle on accroche : 

- la recopie des attributs s'il y en a, 

- la recopie des enfants s'il y en a. 

Si cette regie s'applique a un attribut, eiie dit que ia recopie d'un attribut, c'est ia copie 
de cet attribut, suiviedeia recopie deses attributs ou de ses enfants. Maisun attribut n'a 
ni attribut ni enfant ; ia recopie d'un attribut se resume done a ia copie de cet attribut, ce 
qui mafoi sembieassezsatisfaisant pour i 'esprit. 

Traduite en XSLT, cette regie devient : 

<xsl itemplate niatch="child: :*|attribute: :*"> 
<xsl :copy> 

<xsl lapply-templates select="attribute: :*"/> 
<xsl lapply-templates select="child: :*"/> 
</xsl :copy> 
</xsl itempl ate> 

Notonsquechild: :* est ia forme ionguede "*", etque<xsl :apply-templates select= 

"child: :*"/> seiectionne moins de types de noeuds que <xsi :appiy-tempiates/>. En 
effet, ce sont tous ies enfants du noeud courant qui sont seiectionnes par i 'instruction 
xsi :appiy-tempiates, pas seuiement ceux qui sont des elements, mais aussi Ies textes, 
Ies commentaires et Ies processing-instructions. 

M ais la fa§on dont la regie est ec rite, ci-dessus, renforce le paralleleavec la definition en 
langue naturelle telle qu'on I'a etablie. 



Note 

II feut remarquer ici que I'ordre relatif des deux instructions xsi : apply- templates est important, car il fautse 
rappeler ici qu'il est interdit d'accrocher un attribut a un nceud si on a deja commence a accrocher des enfants 
(voirRegle XSLT typique, page 291). 

Est-on arrive a la forme definitive de cette regie? Pas tout a fait. Pour I'instant nous 
traitons Ies elements et Ies attributs, mais il y a d'autres types de noeuds possibles : le 

type text, le type namespace, le type comment, le type processing-instruction, et 

letype root. 

Nous avonsvu (voir Copie d'un na?ud detype element, page 326 et Copie d'un na?ud de 
type namespace, page 338) qu'un noeud de type namespace est copie automatiquement 
par I'instruction <xsi:copy> appliquee a un element, il n'est done pas necessaire de 
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s'occuper explicitement des domaines nominaux. De meme (voir Copie du nceud de type 
root, page 339), la racine root de I'arbre XM L du resultat est creee automatiquement, 
sansqu'il y aitbesoin des'en occuper. Restentlestextes, les commentaireset I es proces- 
sing-instructions. Leur point commun, c'est qu'ils sont cliacun necessairement enfant 
d'un element. 

Si le noeud courant est un element, instruction <xsi :appiy-tempiates select^ 
"child: :*"/> ne selectionne que des elements (voir Le determinant est une *, page 55). 

M aiS I 'instruction <xsl :apply-templates sel ect="chi 1 d : :node( )"/> (OU pi US Simple- 

ment <xsi :appiy-tempiates"/>), selectionne tous les noeuds qui peuvent etre des 
enfants du noeud courant : c'est exactement cela qu'il nous faut, puisque seront compris 
les commentaires, les textes, et les processing-instructions. Mais si on les selectionne, 
encore faut-il que la regie les accepte en entree ; 11 faut done aussi modifier en conse- 
quence I'attributmatch : 

<xsl :template match="child: :node( ) |attribute: :*"> 
<xsl :copy> 

<xsl lapply-templates select="attribute: :*"/> 
<xsl lapply-templates select="child: :node()"/> 
</xsl :copy> 
</xsl :template> 

Cette regie est maintenant correcte, mais on peut la simplifier legerement : 

<xsl itemplate match="child: :node( ) |attribute: :*"> 
<xsl :copy> 

<xsl lapply-templates select="child: modeO | attribute: :*"/> 
</xsl :copy> 
</xsl :templ ate> 

Note 

On peuttoutefois s'interrogersur le bien-fonde de cette simplification, En effeton a maintenant I'union de deux 
node-sets, ce qui donne un nouveau node-set, dans lequel sont melanges des attributs, des elements, des 
textes, etc. Or un node-set n'est pas ordonne ; on peut done craindre que les noeuds ne soient pas traites dans 
le bon ordre (i.e. les attributs avantles elements). En felt, il n'y pas de probleme ici, carxsi :appiy-tempiates 
traite les noeuds du node-set renvoye parte select dans I'ordrede lecture du document. Or I'ordre de lecture du 
document est parfaitement specifie, (voir Representation graphique, page 50), et stipute que pour un element 
donne, les attributs vtennent avant tes enfants. Done ici, nous retombons sur nos pieds, et nous sommes surs 
que tes attributs (s'il y en a) seront traites avant tes autres noeuds. 

La derniere petite touche que I'on peut apporter a cette regie, c'est de la rendre plus sure 
a utiliser dans des contextes differents : 

^ <xsl :templ ate match="child: :node( ) |attribute: :*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" mode="copie"/> 
<xsl :apply-teniplates select="child: :node()" mode="copie"/> 
</xsl :copy> 
</xsl :templ ate> 
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Cette fois, on a une regie qui n'est activee que si on precise le mode « copie » ; elle peut 
done coexister pacifiquement avec d'autres regies ayant un motif similaire, mais des 
transformations completement differentes. 

M ais I! peut aussi arriver que I'on ait besoin que la copie soit conforme par defaut, sauf 
pour certains elements que I'on equipe d'une regie specifique. Dans ce cas, la copie ne 
doit pas etre lancee autoritairement sur tel element particulier, elle doit se lancer toute 
seulequand 11 n'y a aucune autre regie eligible. 

Un exemple de cette idee se trouve mis en oeuvre aux sections Pattern n° 8 - Utilisation 
d'une structure de donne'es auxilaire, page 422 et Pattern n°18 - Localisation d'une 
application, page 533. 

Cela peuttressimplementsefaireainsi : 

<xsl : tempi ate match="chi Id: :node( ) | attribute: :*" priori ty="- 10" > 
<xsl :copy> 

<xsl :apply-teinplates select="attribute: :*" /> 
<xsl :apply-teinplates select="child: :node( )" /> 
</xsl :copy> 
</xsl :templ ate> 

En affectant une priori te extremement faible a cette regie, on est sur qu'elle ne sera selec- 
tionnee que si le processeur XSLT n'a vraiment rien d'autre a se mettre sous la dent, 

Terminons par une remarque concernant le degre de conformite d'une copie conforme : 
le point devue est ici celui du parseur XM L, non celui de I'oeil humain. En particulier, 11 
est impossible a priori de discerner deux documents XML qui ne different que de la 
fagon dont sontecrits les attributs (avec des guillemets ou des apostrophes), ou les textes 
contenant des caracteres interdits comme "<" ou "&" (avec des <! [cdata[<]]> ou avec 
des &it; ), 

Copie presque conforme 

Nous partons ici d'un document XM L contenant du X HTM L genere par Docbook. 

Note 

Docbook est une DTD associee ades feuilles de style XSLT pour rediger des articles, des livres, etplus genera- 
lementde la documentation, Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook, org), 

doc.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<htnil> 
<head> 

<nieta http-equiv="Content-Type" content="text/html ; charset=LITF-16"/> 
<title>Generation de la documentation avec Docbook</titl e> 
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<link rel="stylesheet" href=" . . ess" type="text/css"/> 
<meta name="generator" content="DocBook XSL Stylesheets V0"/> 
</head> 

<body bgcolor="white" text="black" link="#OOOOFF" vlink="#840084" al ink="#OOOOFF"> 
<div class="article"> <div class="titlepage"> 
<div> <hl class="title"> 

<a name="dOel"></a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xml ns="http:/ /www. w3.org/TR/xhtml 1/transitional " 

cl ass="fi 1 ename">C: \DocBook\RunDocBook\extens ions \ verbatim. j a va</tt>, 

qui a finalement 1 'allure suivante: 

<table xml ns="http: //www. w3.org/TR/xhtml 1/transitional " 

border="r bgcol or="#EOEOEO"> 
<caption al ign=" right" class="l istingTitle">verbatim. java</caption> 
<tr><td> 

<pre class="programlisting"> 
// ici listing de programme Java</pre> 
</td></tr> 
</table> 
</p> 

<!-- ... suite du fichier sans importance ... --> 
</div> 
</body> 
</html> 

Le vrai probleme que nous nous posons ici, c'est de modifier le listing qui se trouve 
entre les ballses <pre> . . . </pre> en remplagant les tabulations initiales de chaque 
ligne de code par des series de quatre espaces. Ceci parce que les navigateurs 
comptent en general huit espaces par tabulation, ce qui est beaucoup trop pour 
certains listings. 

Traduit en terme de copie non conforme, cela veut dire que nous cherchons a faire une copie 
conforme du document, a ceci pres que les elements <pre> seront legerement differents dans 
leurcontenu. 

Cependant, ce probleme est curieusement difficile. 

Non pas a cause de la copie en elle-meme, qui repose sur ce qu'on vient de voir, ni a 
cause du remplacementde tabulations par des espaces, qui est simple a real i sen 

Ce probleme est difficile parce que I'element <pre> est un descendant de I'element 
<tabie>, qui declare un domaine nominal par defaut. Cette difficulty est done complete- 
ment hors-sujet dans cette section, mais pour illustrer malgre tout cette notion de copie 
non conforme, nous allons supposer que nous voulons expurger la partie <head> pour ne 
garder que la balise <ti ti e>, tout le reste etant conserve intact. 
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copie.xsl 

<?xml version='1.0' encoding='IS0-8859-l' ?> 
<xsl :styl esheet xml ns :xsl = "http: //www. w3.org/1999/XSL/Transforir" 
version='1.0'> 



<xsl:output method='xnil ' indent="yes" encodings' ISO-8859-r /> 



<xsl : tempi ate niatch="/"> 

<html> 

<xsl :apply-teinplates/> 

</html> 
</xsl :templ ate> 

<xsl itemplate match="/html /head"> 

<head> 

<xsl :apply-teinplates/> 

</head> 
</xsl :templ ate> 

<xsl itemplate niatch="/html /head/*"> 
</xsl itempl ate> 



<xsl : tempi ate match="/html/head/title" priority="2"> 

<xsl lapply-templates select^"." mode="copie"/> 
</xsl itempl ate> 

<xsl itemplate match="body"> 

<xsl lapply-templates select="." mode="copie"/> 
</xsl :template> 

<xsl :template match="child: :node( ) | attribute::*" mode="copie"> 
<xsl :copy> 

<xsl :apply-teinplates select="@*" mode="copie"/> 
<xsl :apply-templates sel ect="node( ) " mode="copie" /> 
</xsl : copy> 
</xsl :templ ate> 



</xsl :stylesheet> 

La copie est lancee sur deux elements : <titie> et <body> ; le reste est reconstruit a 
la main, eteventuellement modifie. Ici la non conformite de la copie est due a la regie 
<xsi :tempiate match="/htmi /head/*"> ; cette regie annule tous les elements 
enfants de <head>, sauf <titie>, qui beneficie d'une regie a part. On remarquera 
d'ailleurs la priorite 2 imposee a cette regie a part, pour eviter I'ambiguite avec la 
regie d'annulation. 

Leresultatobtenu estbien celui qu'on attendait, 
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Pattern n° 11- Detection d'un element avec domaine nominal 
par defaut 

Motivation 

La motivation est tres simple: on veut ecrire une transformation XSLT (peu importe 
laquelle) qui necessited'ecrire une certaine regie pour un certain eiement. En principe, ii 
n'y a rien depiusfaciieafaire, il suffit d'ecrire parexemple: 

<xsl itempl ate match="trLic"> 
^ </xsl itempl ate> 

Le probieme qui peut survenir est que dans le document source XML, I'element <truc> 
soit associe a un domaine nominai par defaut, 

La regie ci-dessusn'estalors jamais activee, carle motif utilise, true, concordeavec tout 
element <truc> sans domaine nominal, mais pas avec un element possedant un domaine 
nominal, qu'il soitexpliciteou par defaut. 

Une solution decontournementpeuteventuellementetremiseen place, commececi : 

1 <xsl itempl ate match="*[ local-nameO = 'true' ]"> 
I </xsl itempl ate> 

Cela fonctionne, car "*" ramasse tout ce qui se trouve sur I 'axe chiidi :, et ensuite on 
filtre pour ne garder que les elements dont le nom estegal a la chalne 'true' . 

M ais ce n'est pas extraordinaire comme style, car cette regie sera selectionnee sur tout 
element, puis presque toujours rejetee a cause du predicat. Par ailleurs, on ne fait que 
contourner le probieme, alors qu'on pourrait le resoudre. 

Solution 

La solution passe evidemment par I'ecriture d'un motif qui Concorde avec un element 
<truc>, dans un certain domaine nominal par defaut. 

Une chose est certaine, c'estque: 

I <xsl itempl ate match=''truc"> 

concordeavec tout element <truc> qui n'est dans aucun domaine nominal. 

Si I 'on veut ecrire un motif qui concorde avec un element <truc> dans un certain 
domai ne nomi nal , i I faut absol ument ecri re quel que chose du genre : 

^ <xsl itempl ate match=''xxitruc"> 

ou XX represente un prefixe (ou abreviation) d'un certain domaine nominal. 

Mais c'est precisement la que la difficulte surgit: si on ajoute un prefixe, le domaine 
nominal n'est plus « par defaut», penserez vous. Certes, mais ou? Parlons-nous d'un 
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domaine nominal « par defaut» dans le programme XSLT, ou « par defaut» dans le 
document source XM L ? 

Un domaine nominal, cela reste un domaine nominal, qu'il soit par defaut ou non. C'est 

done quel que chose dU genre : http://www.machinchose.fr/bidule, 

Si le document source sepresentecommececi : 

<machin xmlns=" http://www.machinchose.fr/bidule"> 
<truc> 

</truc> 
</machin> 

i'eiement <truc> a un domaine nominal par defaut. 
Si le document source se presente comme cela : 

<machin xmlns:xx="http:/ /www. inachinchose.fr/bidule"> 
<xx:truc> 

</xx:truc> 
</machin> 

I'eiement <truc> a un domaine nominal explicite. 

Le point un peu subtil, maisici essentiel pour obtenir la solution, c'est que dans lesdeux 
cas, le domaine nominal peut tres bien etre le m^me, la seule difference r<?sidant dans la 
fafon de le dire. 

Done une regie telle que : 

^ <xsl : tempi ate match="xx:truc"> 

n'est pas une regie concordant avec 

tout element "true" dont le prefixe est "xx" 

mais avec 

I tout element "true" dont le domaine nominal est 
I http://www.machinchose.fr/bidul e 

en supposant que xx soit I'abreviation de ce domaine nominal. 

La solution, pastres evidente, 11 faut bien le reconnaitre, est done de declarer un domaine 
nominal explicite dans le programme XSLT, comme ceci : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 



xmlns:xx=" http://www.mach inchose.fr/bidule" 



Patterns de transformation 

Chapitre 9 

|version='1.0'> 
<!-- etc --> 

puis d'ecrire la regie en faisant mention du domaine nominal requis : 

<xsl :templ ate match="xx:truc"> 
I </xsl :template> 

Le document source XML est suppose etre de la forme suivante : 

<machin xinlns=" http://www.machinchose.fr/bidule"> 
<truc> 

</truc> 
</machin> 

Le motif de la regie ci-dessus Concorde avec tout noeud <truc> dans le domaine nominal 
http://www.machinchose.fr/bidule ; or c'est precisement le cas de I'element <truc> du 
fragment XML ci-dessus. Done la regie s'appliquera bien a I'element <truc> en ques- 
tion, 



Note 

Cette fegon de rescudre le probleme esttellementpeu intuitivementevidente, qu'elle a feitl'objetd'une requete 
officielle d'amelioration pour la version XSLT 2.0. On pourra consulter, dans http://www.w3.org/TR/xslt20req, la 
section intitulee « 2.1 Must Allow Matching on Default Namespace Without Explicit Prefix ». 



Exemple 

Nous allons pouvoir revenir au probleme de la copie non conforme dont 11 etait question 
a la section Copie presque conforme, page 447, et arriver cette fois a une solution satis- 
faisante au probleme pose, Rappelons qu'il s'agit de modifier legerement le document 
XHTM L produit par Docbool<, en intervenant uniquement dans les ballses <pre ciass= 
"programiisting">, afin de supprimer les tabulations initiales de chaque ligne, en les 
rempla^ant par des series de quatre espaces. 

Void toutd'abord un extraitdu document XHTM L a transformer : 

doc. html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=LITF-16"/> 
<title>Generation de la documentation avec Docbook</title> 
<link rel="stylesheet" href="..css" type="text/css"/> 
<meta name="generator" content="DocBoDk XSL Stylesheets VG"/> 
</head> 

<body bgcolor="white" text="black" 1 ink="#OOOOFF" vl ink="#84G084" 
alink="#OOOOFF"> 
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<div class="article"> <div class="titlepage"> 
<cliv> <hl class="title"> 

<a nanie="dOel"></a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<div class="sectl"> <div class="titlepage"> 

<div> <h2 class="title" style="clear: both"> 

<a name="d0e38"></a>l . Documentation avec docbook 
</h2> 
</div> 
</div> 

<div cl ass="sect2"> <div class="titlepage"> 
<div><h3 class="title"> 



</div> 
</div> 

<div cl ass="sect3"> <div class="titlepage"> 
<div> <h4 class="title"> 

<a naine="d0e231"></a>1.2.6. puratim.cl ass 
</h4> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xml ns=" http://www.w3.org/TR/xhtml 1/transi tional " 
cl ass="f i 1 ename">C: . java</tt> , 

qui a finalement 1 'allure suivante: 



<tabl e xml ns="http: //www. w3.org/TR/xhtml 1/transi tional " 

border="l" bgcolor="#EOEOEO"> 
<caption align=" right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 

<pre class="programlisting"> 
import java.io.*; 
public class puratim ( 

public static void main( String arg[] ) { 
try { 

Fi 1 eInputStream fis = new FileInputStream( arg[0] ); 
InputStreamReader isr = new InputStreamReaderC fis, "UTF-16" ); 
BufferedReader in = new BufferedReader( isr ); 
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<a name="d0e46"> 

</a>1.2. Description des principaux fichiers utiles 
</h3> 



line = in . readLine( ) ; // la T ligne n'est pas recopiee 
// (c'est la reference au graphe) 



for(::){ 
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1 ine = in.readLineC ) ; 

if ( line null ) break; 

pw.printlnC line ); 

} 

} 

} 

}</pre> 
</td> 
</tr> 
, </table> 
</p> 

<p>A priori le service "Securite des reseaux" est au courant de ce probleme, 

qui devrait done etre resolu dans les jours qui viennent. 

Lorsque ce sera le cas, on pourra supprimer ce fichier 

<tt xinlns=" http://www.w3.org/TR/xhtmll/transitional " 

cl ass="f ilenanie">puratim.cl ass</tt> 

</p> 

</div> 
</div> 
</div> 
</div> 
</body> 
</html> 

On voit que le probleme de la detection d'un element dans un domaine nominal par 
defaut va se poser ici, puisque I'element <pre . . .> fait partie de la descendance de 
<tabie ...>, qui declare le domaine nominal par defaut http://www.w3.org/TR/ 

xhtml l/transi ti onal . 

On va done mettre en oeuvre la solution indiquee plus haut; cela consiste d'abord a 
declarer un domaine nominal identique, identifie par une abreviation quelconque qui 
servira de prefixe. On ecrira done : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xinlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xmlns:dns=" http://www.w3.org/TR/xhtmll /transitional " 

version='1.0'> 

<!-- etc --> 

Ensuite, puisque I'on veut tout copier a I 'identique, sauf precisement les elements <pre 
cl ass="programi i sting">, il va falloir ecnre une regie speciale pour ces elements : 

<xsl :templ ate match="dns:pre"> 
<pre class="programlisting"> 

<xsl :cal 1 -tempi ate name="repl ace_f i rst_tabs_on_al 1_1 ines"> 
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<xsl iwith-param nanie="codeSource" select^"." /> 
</xsl : call -tempi ate> 
</pre> 
</xsl :templ ate> 

La regie ci-dessus semble correcte. Et pourtant ... Nous ne sommes pas au bout de nos 
peines avec les domaines nominaux. Telle qu'indiquee, la regie est correcte, du moins 
dans I'expression du motif : c'est tout I'objet de la discussion de la section precedente. 
Le corps de la regie, par contre, va poser a nouveau probleme; void ce que I 'on va obtenir 
lorsquelemodelede transformation decette regie sera instancie : 

<pre 

xmlns="" 

xmlns:dns=" http://www.w3.org/TR/xhtmll/transitional " 

cl as s= "prog rami isting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 

}</pre> 

Dans le document resultatgenere, I 'element <pre . . .> est defini avec un domaine nomi- 
nal par defaut nul (xmins="") ; cela signifie que cet element ne fait partie d'aucun 
domaine nominal pardefaut, 

On a de plus une definition du domaine nominal http://www.w3.org/TR/xhtmii/tran- 
sitionai, deja declare dans I'element <tabie . . .>, mais comme domaine nominal par 
defaut, alors qu'ici, 11 est associe au prefixe dns. Pourquoi pas? Apres tout, ce qui 
compte, c'est que I'element soit associe au bon domaine nominal ; que ce soit par le 
truchementd'un domaine nominal par defaut ou explicite, peu importe. 

Oui, mais malheureusement, I'element <pre> n'a pas de prefixe. Et comme il ne fait 
desormais plus partie d'aucun domaine nominal par defaut, <pre> n'est done associe a 
aucun domaine nominal. En cela, la copie que nous avons realisee est trop infidele, car 
nous ne voulions pas modifier quoi que ce soit aux domaines nominaux, mais seulement 
faire sauter les tabulations. 

Cette fois, cependant, le probleme n'est pas difficile a identifier et a corriger ; c'est la 
regl e que nous avons ecri te qui est i ncorrecte, car el I e uti I i se I 'element I i tteral sans I e pre- 
fixe dns. Or, dans le programme XSLT, il n'y a pas de domaine nominal par de'faut ; 
ainsi, un element litteral, comme <pre>, qui apparait sans prefixe, est un element sans 
domaine nominal. Le processeur XSLT a done genere une declaration d'annulation de 
domaine nominal (sous la forme xmins="") afin d'obeir a nos ordres. 

Le plus dur est peut-etre de realiser qu'on a effectivement donne cet ordre. 

Ayant vu cela, la correction est immediate : 

<xsl : tempi ate match="dns:pre"> 

<dns:pre class="programl isting"> 

<xsl : cal 1 -tempi ate name="repl ace_f i rst_tabs_on_al 1_1 i nes"> 
<xsl :with-param name="codeSource" select="." /> 
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</xsl :call-teniplate> 
</clns:pre> 
</xsl :teniplate> 

Avec cette regie corrigee, on obtiendra ceci : 

<dns :pre 

xmlns:dns=" http://www.w3.org/TR/xhtmll /transitional " 
cl ass="programl isting"> 
import java.io.*: 
public class puratim { 

public static void mainC String arg[] ) { 

}</dns:pre> 

Cette fois, c'est bon, le document resultat est identique au document d'origine du point 
de vue du traitement des domaines nominaux. La seule difference, c'est que dans le 
document d'origine, I'element <pre> est associe a un domaine nominal par defaut, alors 
que dans le document resultat, 11 est associe a un domaine nominal explicite. Mais 
comme dans les deux cas, il s'agit du meme domaine nominal, les deux documents sont 
equival ents du poi nt de vue XML. 

Le programme XSLT est celui-ci (les modeles nommes realisant la suppression effective 
des tabulations ne sont pas montres, car lis sont hors-sujet pour ce qui nous occupe 
actuellement) : 

tabsToSpaces.xsl 

<?xml version='1.0'?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transform" 

xml ns :dns=" http://www.w3.org/TR/xhtml 1/transi tional " 
version='1.0'> 



<xsl:output method^'html ' encoding='IS0-8859-r /> 
<xsl : tempi ate name="repl ace_f i rst_tabs_on_al 1_1 ines"> 
</xsl :templ ate> 



<xsl :templ ate match="/"> 

<xsl :apply-templates niode="copie"/> 
</xsl :templ ate> 

<xsl :template match="dns :pre" mode="copie"> 

<xsl :comment>Dans pre[@cl ass='programl i sting] '</xsl :comment> 
<dns :pre cl ass="programl i sting"> 

<xsl : cal 1 -tempi ate name=" repl ace_f i rst_tabs_on_al 1_1 i nes"> 

<xsl :with-param name="codeSource" select="." /> 
</xsl :call -template> 
</dns:pre> 
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</xsl itempl ate> 

<xsl itemplate match="child: :node( ) | attribute::*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="@*" mode="copie"/> 
<xsl :apply-templates sel ect="node( ) " mode="copie" /> 
</xsl :copy> 
</xsl :templ ate> 

</xsl :stylesheet> 

Et voici maintenant le resultat obtenu (la presentation a ete remaniee pour les besoins de 
la miseen page) : 

docSansTabs.html 

<htnil> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<nieta http-equiv="Content-Type" content="text/html ; charset=UTF-16"> 
<title>Génération de la documentation avec Docbook</title> 
<link rel ="styl esheet" href="..css" type="text/css"> 
<meta name="generator" content="DocBook XSL Stylesheets V0"> 
</head> 

<body bgcolor="white" text="black" 1 ink="#OOOOFF" vl ink="#840084" 
alink="#OOOOFF"> 
<div c1 ass="arti cl e"> 
<div class="titlepage"> 
<div> 

<hl class="title"> 
<a name="dOel"></a> 

Génération de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<div cl ass="sectl"> 

<div class="titlepage"> 
<div> 

<h2 class="title" style="clear: both"> 
<a name="d0e38"></a>l . Documentation avec docbook 
</h2> 
</div> 
</div> 

<div cl ass="sect2"> 

<div cl ass="titl epage"> 
<div> 

<h3 class="title"> 
<a name="d0e46"></a> 

1.2. Description des principaux fichiers utiles 
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</h3> 
</div> 
</div> 

<div cl ass="sect3"> 

<div cl ass="titl epage"> 
<div> 

<h4 class="title"> 

<a name="d0e231"></a>1.2.6. puratim. class 
</h4> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xinlns=" http://www.w3.org/TR/xhtmll/transitional " 

cl ass="f il ename">C: . java</tt> , 

qui a finalement 1 'allure suivante: 

<table xmlns=" http://www.w3.org/TR/xhtmll/transitional " 
border="l" bgcol or="#EOEOEO"> 
<caption al ign=" right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 

<!--Dans pre[@class='programli sting] ' --> 
<dns:pre 

xml ns:dns=" http://www.w3.org/TR/xhtm1 1/transi tional " 
cl ass="programl isting"> 
import java.io.*: 
public class puratim { 
public static void main( String arg[] ) { 
try { 

Fi 1 eInputStream fis = new Fi 1 eInputStream( arg[0] ); 
InputStreamReader isr = new InputStreamReader( fis, "UTF-16" ); 
BufferedReader in = new BufferedReaderC isr ); 

line = in.readLine( ) ; // la 2° ligne n'est pas recopiée 

// (c'est la réfé rence au graphe) 

for(:;){ 

line = in. readLine( ) ; 

if ( line null ) break; 

pw.println( line ); 



} 

} 

</dns :pre> 
</td> 
</tr> 
</table> 
</p> 
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<p>A priori le service "Sécurité des réseaux" 
est au courant de ce probl&egrave:nie, qui devrait done être 
résol u dans les jours qui viennent. Lorsque ce sera le cas. 
on pourra supprlmer ce fichler 

<tt xmlns="http: //www. w3.org/TR/xhtml 1/transi tlonal " 
cl ass="f ilenaine">puratim.cl ass</tt> 

</p> 

</div> 
</d1v> 
</div> 
</div> 
</body> 
</html> 

Si I'on compare maintenant le document original et celui obtenu, on constate des diffe- 
rences de presentation, et d'encodage des caracteres non A sci i , mais aucune difference de 
structure X M L , On a les meme elements, avec les memes attributs et les memes domai- 
nes nominaux. La suppression des tabulations n'est pas visible ici, mais ce n'est pas vrai- 
ment le sujet qui nous a donne du travail. On pourra toutefois trouver une discussion 
specifique sur ce sujet a la section Exemple, page 402. 

Finalement, on volt que ce n'est pas forcement si evident que 5a de realiser une copie 
presque conforme d'un document utilisant les domaines nominaux. M ais les solutions a 
mettre en oeuvre, pour ces problemes de domaines nominaux, sont assez generiques ; 
elles sont done parfaitement reutilisables dans d'autres circonstances, sans rapport avec 
des copies presque conformes. 

Pattern n° 12- References croisees inter fichiers 

Motivation 

L es problemes de references croisees sont tres frequents en X SLT ; ce sont des problemes 
ou, pour traiter une information A, 11 faut en deduire une information B, puis rechercher 
cette information B, eventuellement dans un autre document, qui donne acces a une 
information C. On peut alors presenter cote a cote les informations A etc. 

S'il y a beaucoup d'informations A a traiter, le point critique est la recherche deB dans 
tout un document, car cette recherche est multipliee par le nombre de A a traiter 

Une solution efficace consiste alors a indexer les informations A par les informations B, 

en utilisant le couple instruction xsl :key/fonction keyO. 

Nous allons montrer cela sur un exemple mettant en oeuvre deux fichiers sourceXM L, 

Pour cela nous reprenons I'exemple que nous avions vu a la section Exemple, 
page 307. Nous avions un fichier codesPiages.xmi contenant des informations sur des 
codes utilises par ailleurs : 
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codes PI ages .xml 

<?xml version="1.0" 
<codes> 

<artistes> 

<artiste id= 
<artiste id= 
<artiste id= 
<artiste id= 
<artiste id= 
<artiste id= 
<artiste id= 
</artistes> 



encoding="IS0-8859-l"?> 



"cplu" name="Christine Plubeau"/> 

"nspt" name="Noel 1 e Spieth"/> 

"eblq" name="Eric Bellocq"/> 

"fmrt" name="Frederic Martin"/> 

"oded" nanie="Odile Edouard"/> 

"fech" nanie="Freddy Eichelberger"/> 

"dsmp" nanie="David Simpson"/> 



<instruments> 

<instrument id="vdg" 

<instrument id="clv" 

<instrument id="thb" 

<instrument id="vU" 

<instrument id="vl2" 

<instrument id="org" 

<instrument id="vlc" 

</instruments> 



name="Viole de gambe"/> 
name="Clavecin"/> 
name="Theorbe"/> 
name="Violon baroque"/> 
name="Violon baroque"/> 
name="Orgue positif"/> 
name="Violoncelle baroque"/> 



</codes> 



Parailleurs, nousavionsunfichierXM L contenantdes descriptions de plages deCD, mis 
en pi ace dans ce memeexemple, et modi fie par la suite pour illustrer leprincipedenume- 
rotation des noeuds (voir Exemple, page 350). 



PlagesCD.xml 

<?xml version= 
<pl ages> 



'1.0" encoding="IS0-8859-l"?> 



<plage No="l" vdg="cplu" clv^'pspt" 

thb="eblq" vU^-fmrt" 

vl2="oded" org=''fech"> Grave </plage> 

<plage No="2" thb="eblq" 

clv="nspt" vll="fmrt" 

vl2="oded" vlc="dsmp"> Presto / Prestissimo </plage> 

<plage No="3" vdg="cplu" clv^'rispt" 

thb="eblq" vll="fnirt" 
vl2="oded"> Adagio </plage> 



<plage No="4" thb="eblq" vdg="cplu 
clv="nspt" vll="fmrt 
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vl c="dsmp" 

org="fech"> Presto Recit de basse </plage> 

</pl ages> 

Ce fichier indique, pour chaque plage, la distribution sous forme d'attributs dont les 
noms sont des codes d'instruments, et les valeurs sont des codes d'artistes. Tous ces 
codes ont leur traduction en clair dans le fichier codesPiages.xmi. II s'agit maintenant 
d'ecrire une transformation XSLT qui permette d'obtenir le fichier suivant (qui, mis en 
forme, pourrait figurer dans la pochette du disque, puisqu'il donne pour chaque artiste, 
les numeros de plages ou il intervient, et ^instrument dont 11 joue) : 

Resultat attendu 



Christine Plubeau 
13 4 Viole de gambe 



Noelle Spieth 
12 3 4 Clavecin 



Eric Bellocq 
12 3 4 Theorbe 



Frederic Martin 

12 3 4 Violon baroque 



Odile Edouard 

12 3 Violon baroque 



Freddy Elchelberger 
1 4 Orgue positif 



David Simpson 

2 4 Violoncelle baroque 

Pulsque I'on veut un fichier ou les informations soient classees artiste par artiste, il semble 
logique de considerer que le fichier codesPi ages .xmi sera le fichier principal, et I 'autre le 
fichier secondai re. Lecheminementpeutalorssefairecommececi : 

1) Partantd'un <artiste>, on a son id (par exemplecplu) etson nom (Christine Plubeau). 

2) Connaissant I'id cplu on va rechercher dans le fichier piagesCD.xmi toutes les 
<pi age> qui ont un attribut dont la valeur est cplu, ce qui permet d'afficher les numeros 
de plages. 

2) Puis ayant I'une de ces plages, il faut noter le nom de I'attribut dont la valeur 
correspond a la valeur cherchee (cplu dans I'exemple), ce qui nous donne le code 
de I 'instrument joue (vdg, en I'occurrence). 

2) Enfin, ayant ce code, on revient dans le document source principal, oul'on recherche un 
instrument dont le code correspond, et il n'y a plus qu'a afficher le nom de cet instrument. 
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Realisation 

L a premiere chose a faire est de mettre en place une table d'association qui va donner des 
<piage>, connaissant des id d'artistes. 

Or, dans le fichier piagesCD.xmi, les id d'artistes ne sont pas references par des attributs 
dont le nom est fixe ; il suffit qu'on ajoute un nouvel instrument, pour que cela donne un 
nouveau nom d'attribut, dont la valeur est un id d'artiste. La cle sera done declareeainsi : 

|<xsl :key nanie="PlagesParCodesArtistes" 
inatch="pl age" use="attribute: :*" /> 

Comme I'attribut use est une expression renvoyant un node-set, chaque valeur textuelle 
de chaque noeud de ce node-set va jouer le role de valeur de cle ; une fois construite, la 
table va done avoir I'allure representee a la figure 9-1. 




Figure 9-1 

Plages par codes artistes, 
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De meme, il va nousfalloir une cle pour avoir un <instrument> connaissant son id ; 

|<xsl :key nanie="InstruinentsParCodesInstruments" 
match="instrument" Lise="attribute: :id" /> 



Note 

On pourrait ici utiliser la fonction id( ), qui renvoie Telement dont I'identifiant est egal a une valeur donnee, 
Neanmoins, on ne le fait pas, car la manipulation d'identifiant est plus lourde :il faut declarer I'attributcorrespon- 
dantdu type predefini ID, ce qui de fait, oblige a equiperle fichierXML d'une DTD. Une cle apporte ici beaucoup 
plus de souplesse, en nous affranchissantcompletementde I'obligation d'une DTD, 



Ceci etant, on peutcommencer a coder la transformation. L e but etantde I isterdes artistes, 
on va done partir du fichier codesPiages.xmi, ettraiter les elements <artiste> : 

<xsl itemplate niatch="artiste"> 
<xsl itemplate niatch="artiste"> 

<xsl :cal 1 - tempi ate naine="instancier-NomArtiste"> 

<xsl iwith-param nanie="nomArtiste" select=''@noni"/> 
</xsl : call -tempi ate> 

<xsl :cal 1 -tempi ate name="instancier-NosPl agesAvecCetArtiste"> 

<xsl :with-param name^'codeArtiste" select="@id"/> 
</xsl : cal 1 -tempi ate> 

<xsl :cal 1 -tempi ate name="instancier-NomInstrunientDeCetArtiste"> 

<xsl :with-param nanie="codeArti ste" select="@id"/> 
</xsl :call-template> 

</xsl :templ ate> 

</xsl :templ ate> 

1 1 s'agit maintenant de determiner les trois model es nommes. 

Instanciation du nom de I'artiste 

II n'y a pas de difficulte particuliere ici : 

<xsl itemplate name="instancier-NomArtiste''> 
<xsl iparam name="nomArtiste"/> 



<xsl :value-of sel ect="$nomArti ste"/> 
<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl itempl ate> 

Instanciation des Nos de plages 

II faut maintenant construire la table associee a la cle piagesParCodesArtistes, 
construction qui doitsefaireen explorant I e fichier XM L auxiliaire piagesCD.xmi. C'est 
la fonction keyo qui realise cette tache, et on salt que I'arbre explore est celui qui 
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contient le noeud contexte de ['evaluation de I'expression contenant I'appel. Pour explo- 
rer I'arbre X M L du document contenu dans piagesCD.xmi, il faut done placer le noeud 
contexte de cet appel quelque part dans cet arbre. La racine n'etant pas un plus mauvais 
endroitqu'un autre, on peutdonc obtenir I'effet desire en ecrivant : 

<xsl :template name="instancier-NosPlagesAvecCetArtiste"> 
<xsl :param name="cocleArti ste"/> 

<xsl :for-each select=" document ( ' PI agesCD.xml ' ) "> 

<!-- 

ici le nffiud contexte est la racine de I'arbre XML du document 
contenu dans PiagesCD.xmi, car la fonction documentO renvoie 
un node-set ne contenant que la racine du document demande. 

--> 

</xsl :for-each> 
</xsl :templ ate> 

En mettant I'appel a key ( "PlagesParCodesArtistes". $codeArtiste ) a la place dU 

commentaireci-dessus, on va done construire une table d'apres le bon fichier XM L. 

M ais cet appel est susceptible de renvoyer plusieurs noeuds, puisque un meme artiste peut 
intervenir pour plusieurs plages du CD. II faut done explorer un par un les noeuds ren- 
voyes, avec un xsi :for-each , dans lequel le noeud contexte est a nouveau change, et 
passe tour a tour sur chaque <pi age> renvoyee : 

<xsl : tempi ate name="instancier-NosPl agesAvecCetArtiste"> 
<xsl:param name="codeArti ste"/> 

<xsl :for-each select=" document ( ' PI agesCD.xml ' ) "> 

<xsl :for-each select='key( "PlagesParCodesArtistes", 

$codeArtiste )'> 
<xsl :value-of select=". /attribute: :No"/> 
<xsl:text> </xsl:text> 
</xsl :for-each> 
</xsl :for-each> 

</xsl :templ ate> 

Instanciation des noms d'instruments 

Si I'on connatt lecode instrument, un appel a 

, key( "InstrumentsParCodesInstruments" , $codeInstrument ) 

renvoie r<instrument> cherche. Ici, I'arbre XML a explorer est celui du document 
source principal, done en principe, le noeud contexte, quel qu'il soit, est dans cet arbre: 
inutile ici d'immerger I'appel a keyo dans un xsi:for-each pour placer le noeud 
contexte dans le bon arbreXM L, Ayant l'<instrument> cherche, il n'y a plus qu'a prendre 
la valeurdeson attribut nom . 
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<xsl itemplate name="instancier-NomInstrumentDeCetArtiste"> 
<xsl iparam naine="codeArtiste"/> 
<xsl ivariable name="codeInstrunient"> 

<xsl :cal 1 - tempi ate naine="instancier-codeInstrument"> 

<xsl :with-param name="idArtiste" sel ect="$codeArti ste"/> 
</xsl :call-template> 
</xsl :variable> 



<xsl :val ue-of select^'keyC "InstrumentsParCodesInstruments" , 

$codeInstrument )/attribute: mom' /> 



<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl :templ ate> 

L e probleme est done d'obtenir le code instrument connaissant le code artiste. U n appel a 

I key( "PlagesParCodesArtistes", SidArtiste ) 

renvoie les plages oul'artisteintervient, a condition bien sur que cet appel soitplacedans 
un xsi :for-each pour que le noeud contexte indique le bon arbreXM L, commea la sec- 
tion precedente (voir Instanciation des Nos de plages, page 463). Ayant I'ensemble des 
plages pour un artiste donne, on considerel'uned'elle, peu importelaquelle. La premiere 
est le choix le plus simple, car si cet ensemble n'est pas vide, on est sur que la premiere 
existe : 

<xsl ivariable name="unePlageAvecCetArtiste" 

select^' key( "PI ages Pa rCodes Artistes" , 
$idArtiste )[1]' /> 

Ayant une plage, par exemple : 

<plage No="3" vdg="cplu" clv="nspt" 
thb="eblq" vll="fmrt" 

vl2="oded"> Adagio </plage> 

et connaissant le code artiste, par exemple "cpiu", 11 faut en deduirelenom del'attribut 
dont la valeur est "cpiu- (ici vdg). Dans I'ensemble des attributs de la plage courante, 11 
faut done recuperer celui dontia valeur est cell edu code artiste donne : 

$unePlageAvecCetArtiste/attribute: :*[ . = SidArtiste ] 

Ayant I'attribut (qui est un noeud de type attri bute), 11 n'y a plus qu'a appel er la fonc- 
tion predefinie local -name qui va renvoyer son nom, correspondant au code instrument ; 
ce qui nous donne le modele nomme d'instanciation de ce code instrument 

<xsl itemplate name="instancier-codeInstrunient"> 
<xsl iparam name="idArtiste"/> 
<xsl :for-each sel ect="docunient( 'PlagesCD.xml ' )"> 
<xsl ivariable name="unePlageAvecCetArtiste" 

sel ect=' key( "PI ages Pa rCodes Artistes" , 
SidArtiste )[1]' /> 
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<xsl :value-of select="local-name( 

SunePl ageAvecCetArtiste/attribute: :* 
[ . = SidArtiste ] )" /> 

</xsl :for-each> 
</xsl :templ ate> 

Programme complet 

En reunissant tous les morceaux, on obtient finalement le programme suivant : 

distribution.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl :key name="Pl agesParCodesArti stes" 

match="pl age" use="attribute: :*" /> 

<xsl :key name="InstrumentsParCodesInstruments" 

niatch="instrument" use="attribute: :id" /> 

<xsl ivariable naine="racinePlages" select="document( 'plagesCD.xml ' )" /> 



<!-- ========================================== --> 

<xsl itemplate naine="instancier-NDniArtiste"> 
<xsl :param name="nomArtiste"/> 

<xsl :text> </xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 

<xsl :value-of select="$nomArtiste"/> 
<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl :templ ate> 



<!-- ========================================== --> 

<xsl : tempi ate name="instancier-NosPl agesAvecCetArtiste"> 
<xsl:param name="codeArti ste"/> 

<xsl :for-each select="$racinePlages"> 

<xsl : for-each select='key( "PlagesParCodesArtistes" 

$codeArtiste )'> 
<xsl :val ue-of select="@No"/> 
<xsl:text> </xsl:text> 
</xsl :for-each> 
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</xsl :for-each> 



</xsl itempl ate> 



<! 



> 



<xsl itemplate name="instancier-NoinInstrLiinentDeCetArtiste"> 
<xsl iparain naine="codeArtiste"/> 
<xsl ivariable name="codeInstrunient"> 

<xsl :cal 1 -tempi ate name="instancier-codeInstrument"> 

<xsl iwith-param nanie="idArtiste" select="$codeArtiste"/> 
</xsl : call -tempi ate> 
</xsl :variable> 

<xsl :val ue-of select='key( "InstrumentsParCodesInstruments" , 



<xsl :template name="instancier-codeInstrument"> 
<xsl:param name="idArtiste"/> 
<xsl :for-each select="$racinePlages"> 

<xsl ivariable name="unePlageAvecCetArtiste" 

sel ect=' key( "PI ages Pa rCodes Artistes" , 
SidArtiste )[1]' /> 

<xsl :value-of sel ect="l ocal -name( 

$unePl ageAvecCetArti ste/attribute: :* 
[ . = $idArtiste ] )" /> 

</xsl : for-each> 
</xsl itempl ate> 

<!-- ========================================== --> 

<xsl itemplate name="instancier-sautLigne"> 
<xsl itext> 
</xsl itext> 

</xsl itempl ate> 



<!-- ========================================== --> 

<xsl itemplate niatch="artiste"> 



$codeInstrument )/attributei inom' /> 



<xsl ical 1 -tempi ate name="instancier-sautLigne"/> 
</xsl itemplate> 



<! 



> 



<xsl ical 1 -tempi ate name="instancier-NomArtiste"> 

<xsl iwith-param nanie="nomArtiste" select="@noni"/> 
</xsl icall-template> 
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<xsl :call-teinplate name="instancier-NosPlagesAvecCetArtiste"> 

<xsl :with-param name="codeArtiste" select="@id"/> 
</xsl :call-template> 

<xsl :cal 1 - tempi ate nanie="instancier-NomInstrumentDeCetArtiste"> 

<xsl iwith-param name="codeArtiste" select="@id"/> 
</xsl :call-teniplate> 

</xsl :templ ate> 



<]-- ========================================== --> 

<xsl itempl ate match="text( ) "/> 



</xsl :stylesheet> 

Pattern n° 13 - Generation d'hyper liens 

Motivation 

Dans la section precedente (voir Pattern n°12 - R«?f<?rences crois«?es inter ^cliiers, 
page459), il s'agissaitdesuivredes references en passant deficliier en ficliier ; ici lepro- 
blemeestdegenerer des liyper-liens. Typiquement, en HTM L, ces liyper liens seront des 
paires<a name="..."> <a href=" ...">. Si HTM L est cite ici en exemple, c'est unique- 
ment parce que les balises <a> sont bien connues ; mais le probleme est exactement le 
meme pour n'importe quel texte ou I'on doitemettre des references a d'autres parties du 
document, et se resout de la meme fagon. 

On serestreintici aun seul document, mais si I'on voul ait emettre des references de type 
<a href=" . . . "> versun autre document, 11 suffiraitde combiner les i dees mises en oeuvre 
dans cette section, avec celles de la section precedente (Pattern n°12 - References 
croisees inter ^chiers, page 459). 

L'idee de base, ici, est d'utiliser la fonction generate-id( ) pour obtenir une chaine de 
caracteres qui pourra servir d'identifiant pour une ancre referengable. 

U ne autre idee est que nous sommes ici dans un domai ne ou la notion de cle d'indexation 
a des chances d'etre utile. 

Prenons par exemple ce fichier XML: 

Saison.xml 

<?xml version="1.0" encoding="LITF-16"?> 
> <Saison> 

I <Periode> Automne 1999 </Periode> 
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<Manifestations> 
<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</LieLi> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 
</Theatre> 
</Manifestations> 

<Adresse> 

<Lieu>Chapel 1 e des Ursul es</Lieu> 

9, rue des Ursules - 49000 Angers 
</Adresse> 

<Adresse> 

<Lieu>Salle des Cordeliers</Lieu> 

1, rue des Prevoyants de I'avenir - 49000 Angers 
</Adresse> 

</Saison> 

On veut obtenir une version HTLM de ce document, avec un lien actif de cliaque lieu 
vers son adresse. Done, arrive sur un <Lieu> de concert ou de theatre, 11 faut referencer 
le <Lieu> correspondant, enfant de <Adresse>. Pour cela, il faut chercher, parmi les 
enfants d'elements <Adresse>, un <Lieu> dont la valeur textuelle soit la meme que 
celle de I'element <Lieu> courant. A ce <Lieu> ainsi trouve, on associera un identifiant 
par la fonction generate-id( ), et cet identifiant servira ensuite de reference pour les 
ballses <a>. 

Si les references a emettre sont peu nombreuses, et le document a traiter peu volumineux, 
cela peut rester acceptable de rechercher le <LieLi> parmi les <Adresse> a chaque fois 
qu'on a besoin d'emettre un <a href=" . . .">. M ais dans le cascontraire, il est beaucoup 
plus efficace de construire une cle d'indexation des <Lieu>. 

Realisation avec reciierciie par cle 

La cle est ici a construire en recoltant des <Lieu> enfants d'elements <Adresse>, en 
prenant la valeur textuelle du <Lieu> comme valeur de cle : 



I <xsl:key name="l ieux" match="Adresse//Lieu" use="." /> 
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Les ancres a generer sont soit de la forme <a href=". . .">, soit de la forme <a name= 
". . . ">. Dans les deux cas, I'attribut sera egal a#abc, ou abc est une chaine de caracteres 
caractehstique, fournie par la fonction generate-id( ). 

Done, connaissant la valeur litterale d'un lieu, par exemple chapeiie des ursuies, on 
recherche le <Lieu> correspondant par la fonction key( ). Le resultat est necessai rement 
un node-seta un et un seul element : on transmetdonc cet element a generate-id( ), etia 
valeur renvoyee va constituer la fin de la reference (le debut etant le caractere '#'). Par 
exemple, 

<a name="#{generate-id(key( 'lieux' , 'Chapeiie des Ursul es ' ) ) )"> 

genere la balise HTIV| L : 

<a name="#d0e56"> 

La valeur dOese n'est pas predictible, bien sflr ; ici, c'est un exemple obtenu avec Saxon, 

Remarquez la fagon dont le descripteur de valeur differee d'attribut est employe: 
"#{ . . . }. Apres leguillemet, la valeur de I'attribut commence par un Ensuitevient le 
descripteur, introduit par le caractere ' { '. Le descripteur est evalue, et sa valeur vient 
s'ajouter au '#' deja pris en compte. On aurait eventuellement pu tout calculer dans le 
descripteur : 

I <a naine="{concat( '#' , generate-id(key( 'lieux' , 'Chapeiie des Ursul es ')))} "> 

U n programme possible de traitement de ce fichier X M L est done le suivant : 

Saison.xsl 

<?xitil version="1.0" encoding=''LITF-16"?> 
<xsl :stylesheet 

xm1ns:xsl=" http://www.w3.org/1999/XSL/Transform'' 

version="1.0''> 

<xsl:output method^'html ' encoding='IS0-8859-r /> 
<xsl:key name="lieux" iratch="Adresse//Lieu" use="." /> 



<xsl itempl ate match=''/"> 
<html> 
<head> 

<title>Programme Saison 
<xsl :value-of 

sel ect= " /Saison /Peri ode "/> 
</title> 
</head> 

<body bgcolor="white'' text="bl ack"> 

<xsl :apply-teniplates/> 
</body> 
</html> 
</xsl itempl ate> 
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<xsl : tempi ate match="Saison"> 

<xsl rapply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl rapply-templates sel ect="Adresse"/> 
</xsl :templ ate> 

<xsl itemplate match="Concert|Theatre"> 

<H3><xsl :val ue-of sel ect="l ocal -name( . ) "/> </H3> 
<p>Date : <xsl :value-of sel ect="Date"/> <br/> 

Lieu : <a href="#{generate-id(key( 'lieux' , ./Lieu))}"> 
<xsl :val ue-of select="Lieu"/> 
</a> 

</p> 
</xsl rtempl ate> 

<xsl :template match="Adresse"> 

<p><a name="#{generate-id( key( ' 1 ieux' , ./Lieu))}"> 
<xsl :va1 ue-of select="Lieu"/> 
</a> 
<br/> 

<xsl :val ue-of sel ect=" ./chi 1 d: : text( ) [2]"/> 
</p> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 



</xsl :stylesheet> 

On notera la faeon d'obtenir letexteassocie a uneadresse : 

I <xsl :value-of sel ect=" . /chi Id: : text( ) [2]"/> 

Le texte utile est le deuxieme, car le premier n'est compose que d'espaces blancs : ce sont 
lesespacesblancs situes entrelafin dela balise <Adresse> etiedebut dela balise <Lieu>. 

Une alternative serait d'utiliser instruction <xsi :stn"p-space> qui supprime tous les 
noeuds text ne contenant que des espaces blancs. Cette solution est meilleure dans la 
mesure ou elleevited'avoir a gerer I 'invisible. Nous la mettrons en oeuvre dans la variante 
dela prochaine section, atitre de comparaison. 

Le resultat obtenu avec Saxon est donne ci-dessous (les valeurs d'ancres dependent du 
processeur utilise) ; voiraussi la figure 9-2, 

Sai son .html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<title>Programme Saison Automne 1999 </title> 
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</head> 

<body bgcolor="white" text="bl ack"> 
<H3>Concert</H3> 

<p>Date : Samedi 9 octobre 1999 20H30 <br> 

Lieu : <a href="#d0e56">Chapel 1 e des Ursul es</a></p> 
<H3>Th&eacute:âtre</H3> 
<p>Date : Mardi 19 novembre 1999 21H <br> 

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Th&eacute:âtre</H3> 
<p>Date : Mercredi 20 novembre 1999 21H30 <br> 

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Adresses :</H3> 

<p><a name="#d0e56">Chapelle des Llrsules</a><br> 
9, rue des Ursul es - 49000 Angers 

</p> 

<p><a naiiie="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Pr&eacute:voyants de I'avenir - 49000 Angers 



</p> 
</body> 
</html> 



Figure 9-2 

Rendu HTM L du 
^chier Saison.html 



J Fichiet Edition Afficliage Favor 



Liens 



Concert 

Date : Samedi 9 Octobre 1999 20H30 
Lieu : Chapelle des Utsules 



Theatre 



Date : Mardi 19 Novembre 1999 21H 
Lieu : Salle des Cordeliers 



Theatre 



Date : Mercredi 20 Novembre 1999 21H30 
Lieu : Salle des Cordeliers 



Adresses : 



Chapelle des Ursules 

9, rue des Ursules - 49000 Angers 

Salle des Cordeliers 

1, rue des Prevoyants de I'avenir - 4900G Angers 



g flle:///C7utilisi| | |g Poste de ttavail ^ 
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Realisation avec rechierchie par expression XPathi 

II n'y a pas de difficulte particuliere a utiliser une expression XPath pour rechercher un 
lieu de meme valeur textuelle que le lieu courant ; leseul petit problemeest I'ecriture du 
predicatou I 'on a besoin a lafoisdu noeud contexteet du noeud courant. Nousavonsdeja 
rencontre ce probleme et vu comment le resoudre : reportez-vous a la fin de la section 
Example, page 187. 

Le programme est donne ci-dessous ; le resultat est exactement identique au precedent. 

L'instruction <xsi : strip-space eiements="*" /> permet de supprimer de I 'arbre X M L 
les noeuds text ne contenant des espaces blancs; en consequence, instruction 
<xsi :vaiue-of sei ect=" . /chii d : : text ( ) "/> est maintenant beaucoup plus naturelle 
que dans la version precedente. 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method^'html ' encoding=' ISO-8859-r /> 
<xsl :strip-space elements="*" /> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title> 

Programme Saison 

<xsl :valLie-of select="/Saison/Periode"/> 
</title> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-teinplates/> 
</body> 
</html> 
</xsl itempl ate> 

<xsl :template match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl lapply-templates sel ect="Adresse"/> 
</xsl :templ ate> 

<xsl :template match="Concert|Theatre"> 

<H3><xsl :val ue-of sel ect="l ocal -name( . ) "/> </H3> 
<p>Date : <xsl :value-of sel ect="Date"/> <br/> 

Lieu : <a href="#{generate-id(/Saison/Adresse/Lieu 

[ . = current( )/Lieu ] 

))"> 
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<xsl :val ue-of select="Lieu"/> 
</a> 

</p> 
</xsl :template> 

<xsl :teiiipl ate match="Adresse"> 

<p><a naine="#{generate-id( ./Lieu)}"> 
<xsl :val ue-of select="Lieu"/> 
</a><br/> 

<xsl :val ue-of sel ect=" . /chi Id: : text( ) "/> 
</p> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 



</xsl :stylesheet> 

Pattern n° 14- Regroupements 

Motivation 

L e regroupement est un probleme tres frequent dans les transformations X SLT. 1 1 se pose 
a chaquefois que le document X M L a traiter contient des informations disseminees ici et 
la, mais ayant toutes un point commun (par exemple, des villes, qui font toutes partie 
d'un pays ; des instrumentistes, qui jouent tous d'un certain instrument ; des pieces (de 
maisons), qui ont toutes une certaine surface, etc.). II y a plusieurs sortes de regrou- 
pements, qui dependent de ce qu'on veut obtenir, et du point de vue adopte pour decider 
du point commun a considerer. 

Dans un regroupement par valeur, le probleme consiste a produire un document resultat 
dans lequel par exemple les villes sont regroupees par pays, les instrumentistes par 
instrument, les pieces par surface, etc. 

Dans un regroupement positionnel, le but est de rassembler des elements dont les posi- 
tions (au sein d'unecertaineliste) sont identiques d'un certain point de vue. Par exemple, 
on a une I iste devil les, et on veut les regrouper trois par trois. 

Enfin, une derniere categorie de regroupement est la restauration hierarchique de docu- 
ments XML. II s'agit ici de reconstituer la structure hierarchique d'un document XML 
qui a ete « aplati » pour une raison quelconque. Un exemple de document plat a deja 
ete rencontre (voir lefichier company. xmi, a la section Exemple plus evolue, page 275) ; 
la restauration hierarchique d'un tel document consisterait a reconstituer un vrai docu- 
ment XML: 

Fichier aplati 

<?xml version="1.0" encoding="LITF-16" ?> 
<table name="COMPANY"> 
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N0ACA<tab/>CHAR(6)<br/> 

LSACAl<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

LAACAl<tab/>VARCHAR2(35)<br/> 

URL<tab/>VARCHAR2(40)<br/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 

</table> 

Fichier restaure 

<?xnil version="1.0" encoding="UTF-16" ?> 
<table name="COMPANY"> 
<field> 

<nanie>NOACA</name> 
<type>CHAR(6)</type> 
</field> 
<field> 

<nanie>LSACAl</name> 
<type>VARCHAR2(35)</type> 
</field> 
etc. 
</table> 



Remarque 

La future version 2.0 de XSLT devraitinclure des possibilites pour specifier des regroupements, parce que tout 
le monde s'accorde a reconnaitre que les regroupements ne sont pas simples a programmer, alors qu'ils font 
partie du quotidien. 



Regroupements par valeur ou par position 

D'une faeon generale, on peut dire qu'on a identifie un probleme de regroupement par 
valeur quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contient certains noeuds N d'un certain type pour lesquels on dispose 
(au moinsconceptuellement) d'une certainefonction valeur, telle que vaieur(N) ren- 
voie un resultat qu'on peut appeler la valeur de N . Suivant ce point de vue, la valeur 
d'un ville, c'est son pays ; la valeur d'un instrumentiste, c'est son instrument ; et la 
valeur d'une piece, c'est sa surface. 

2) Le document resultat doit contenir les noeuds N regroupes par valeurs identiques. 

Un regroupement par position est en fait un cas particulier du precedent, ou la valeur 
d'un element est liee a sa position au sein d'une certaine liste. La position etant donnee 
par un nombre entier, la valeur d'un element, dans ce cas, est done numerique. Par exem- 
ple, si I'on a une liste de villes a regrouper trois par trois, on prendra pour valeur d'une 
ville le tiers de sa position dans cette liste, de telle sorte que chaque groupe de trois soit 
constitue de villes de meme valeur 
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Dans son principe, la solution consistea proceder en deux etapes : 

• Etape 1: on commence par constituer I'ensemble NVD des noeuds de type T de 
valeurs toutes differentes. 

• Etape 2 : on parcourt(2a) I'ensemble NVD, et pour chaque noeud (ayant une certaine 
valeur v) de cet ensemble, on selectionne (2b) I'ensemble des noeuds de type T de 
I'arbreXML qui ontv pour valeur : ces noeuds sontregroupes par valeur. 

L'etape 1 est done une etape de constitution d'un ensemble de valeurs toutes differentes ; 
or nous avons deja vu comment resoudre ce probleme (voir Node-set de valeurs toutes 
diffe'rentes, page 438). La methode de Steve M uench est parti culierement recommandee 
ici, car elle est basee sur la construction d'une cle, qui va aussi servir dans l'etape 2, en 
rendant sa mise en oeuvre particulierement simple. 

Des pieces regroupees par surface habitable (regroupement par valeur 
d'attributs) 

Nous allons continuer le memeexemplequ'a la section Node-set de valeurs toutes diffe- 
rentes, page 438, afin de pouvoir reprendre la realisation obtenue par la methode de la 
cle. 

L e fichier X M L a traiter est le suivant : 
maisons.xtnl 

<?xml version="1.0" encoding="LITF-16" standal one="yes"?> 
<maisons> 

<inaison icl="l"> 
<RDC> 

<cuisine surface='40m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 

<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree. 
</sejour> 

<bureau surface='15m2'> 
Bibliotheque encastree. 

</bureau> 

<garage/> 
</RDC> 
<etage> 

<terrasse>Palmier en zinc figurant le desert. </terrasse> 
<chainbre surface='28in2' fenetre='3'> 

Carrelage terre cuite poncee. 

<alcove surface='8m2' fenetre='r> 
Lambri s . 

</al c6ve> 
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</chainbre> 

<chambre surface='15m2'> 

Lambri s . 
</chainbre> 

<salleDeBains surface='15in2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</ina1son> 
<niaison id="2"> 
<RDC> 

<cu1sine surface='28m2'> 

en ruine. 
</cuisine> 
<garage/> 
</RDC> 
<etage> 

<terrasse> 

vue sur la mer 
</terrasse> 

<salleDeBains surface='15in2'> 

Douche. 
</salleDeBa1ns> 
</etage> 
</ma1son> 
<maison icl="3"> 
<RDC> 

<sejour surface='40m2'> 

paillasson a 1 'entree 
</sejour> 
</RDC> 
<etage> 

<chambre surface='28m2'> 

porte cochere. 
</chainbre> 
</etage> 
</ma1son> 
</ina1sons> 

Lefichier que I'on souhaiteobtenirestcelui-ci : 
pieces.xml 

<?xml version="1.0" encocling="IS0-8859-l"?> 
<piecesParSurfaces> 



<pieces surface="40m2"> 

<cuisine 1clMa1son="l">Evier inox. Mobilier encastre.</cu1sine> 
<sejour idMaison="l''>Chem1nee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande bale vitree.</sejour> 
<sejour idMaison="3''>paillasson a 1 'entree</sejour> 

</pieces> 
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<pieces surface="15m2"> 

<bureau idMaison="l">Bibl iotheque encastree.</bureau> 
<chambre iclMaison="l">Lambri s .</chambre> 

<salleDeBains idMaison="l">Douche, baignoire, lavabo.</salleDeBains> 
<salleDeBains idMaison="2">Douche.</sal leDeBains> 
</pieces> 

<pieces surface="28m2"> 

<chambre idMaison="l">Carrel age terre cuite poncee.</chambre> 
<cuis1ne idMaison="2">en ruine.</cu1sine> 
<chanibre idMaison="3">porte cochere.</chainbre> 
</pieces> 

<pieces surface="8m2"> 

<al cove 1dMa1son="l">Lambri s .</al cove> 
</pieces> 

</p1ecesParSurfaces> 

La realisation de I'etape 1 a deja ete faite, nousavions obtenu la cle : 

<xsl :key name="groupesdeSurfacesParVal eurs" 
inatch="attribute: isurface" 
use="." /> 

et nous avions obtenu ['expression qui donne I'ensemble des valeurs toutes differentes : 

C reation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-id( ) = 
generate-id( 

key ( 'groupesdeSurfacesParValeurs ' , . ) [1] 

) 

] 

La realisation de I'etape 2 est tres simple : 11 suffitdeparcourir I 'ensemble obtenu, cequi 
va nous donner des valeurs toutes differentes, et ensuite, pour chaque valeur, d'exploiter 
la cle pour obtenir les noeuds possedant cette valeur 

malsons.xs! 



<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers1on="1.0"> 

<xsl:output method^'xml ' encodings' ISO-8859-r indent="yes" /> 

<xsl :key name="groupesdeSurfacesParVal eurs" 
match="attribute: :surface" 
use="." /> 



<!-- 
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Etape 1 : constitution d'un ensemble de valours toutes differentes 
================================================================== --> 

<xsl ivariable naine="lesDifferentesSurfaces" 
select="//attribute: :SLirface[ 
generate-id( ) = 
generate-id( 

key( 'groupesdeSurfacesParVal eurs ' , . ) [1] 

) 

]" /> 

<!-- 

================================================================== --> 



<xsl : tempi ate niatch="/"> 
<piecesParSurfaces> 
<!-- 

Etape 2A : parcours des valours de cot ensemble 
=============================================== --> 

<xsl :for-each select="$losDifferentosSurfaces" > <!-- 
— ============================================ --> 

<!-- 

ici le nffiud courant est un ncud attribute: isurface 

--> 

<xsl ivariable name="val eurCourante" select="." /> 

<pieces surface="{$val eurCourante) "> 
<!-- 

Etape 2B : parcours des nsuds ayant cette valour 
==================================================== --> 

<xsl :for-each select="key( 'groupesdeSurfacesParValeurs' , 

$valeurCourante)" > <!-- 
==================================================== --> 

<! — 

ici le ncEud courant est un naud attribute: :surface 

--> 

<xsl ivariable name="pieceCourante" 

select=" . /parent : :node( )" /> 

<xsl : element name="{ local -name($pieceCourante))"> 
<xsl :attribute name="idMaison"> 
<xsl :val ue-of select=" 
$pieceCour ante/ancestor: :maison/@id"/> 
</xsl :attribute> 
<xsl :value-of select=" 

normal ize- space ($pieceCourante/chi Id: : text( ) )"/> 
</xsl :el ement> 
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</xsl :for-each> 
</pieces> 
</xsl :for-each> 
</piecesParSurfaces> 
</xsl :templ ate> 



</xsl :stylesheet> 

Le resultat obtenu est exactement celui montre ci-dessus (a part quelques sauts de lignes 
ajoutes pour la lisibilite). 

Les villes regroupees par pays (regroupement parvaleur d'attributs) 

On suppose qu'on a un fichier XML dormant une liste de villes avec, pour chacune, son 
pays: 

vines.xml 

<?xml version="1.0" encoding="UTF-16" standal one="yes"?> 
<Villes> 

<Ville nom="Paris" pays="France" /> 
<Ville noni="Madrid" pays="Espagne" /> 
<Ville noni="Milan" pays="Italie" /> 
<Ville noni="Rome" pays="Ital ie" /> 
<Ville nom="Angers" pays="France" /> 
<Ville nom="Barcel one" pays="Espagne" /> 
<Ville noni="\/enise" pays="Ital ie" /> 
<Ville noni="Cordoue" pays="Espagne" /> 
<Ville noni="Napl es" pays="Ital ie" /> 
</Villes> 

On veut la liste des villes par pays. La methode est exactement la meme, bien que le 
fichier XM L a traiter soit d'un structure assez differente : 

villes.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl :key name="groupesDePaysParNonis" 
niatch="attribute: :pays" 
use="." /> 

<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl ivariable name="lesDifferentsPays" 
select="//attribute: :pays[ 
generate-id( ) = 
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generate-id( 

key( 'groupesDePaysParNoms' , . )[1] 

) 

]" /> 

<!-- 

================================================================== --> 

<xsl :templ ate niatch="/"> 
<!-- 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xs1 :for-each select="$lesDifferentsPays"> <!-- 
=============================================== --> 

<!-- 

ici le nffiud courant est un ncEud attribute: :pays 

--> 

- <xsl :value-of select="."/> : 

<xsl :variable name="tousLesAttributsPaysDeMemeValeur" 

select="key( 'groupesDePaysParNoms' , .)" /> 

<!-- 

Etape 2B : parcours des ncuds ayant cette valeur 
========================================================= --> 

<xsl :for-each select^'StousLesAttributsPaysDeMemeValeur") <!-- 
========================================================= -> 

<!-- 

ici le noEud courant est un ncud attribute: :pays 

--> 

<xsl :variable name="l aVIl 1 eCorrespondante" 
select^" ./parent: :node( )" /> 
. <xsl :value-of sel ect="$l aVi 1 1 eCorrespondante/@nom"/> 

</xsl :for-each> 
</xsl :for-each> 

</xsl :templ ate> 

</xsl :stylesheet> 

Resultat 

- France : 

. Paris 
. Angers 

- Espagne : 



Madrid 
Barcel one 
Cordoue 
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- Italie : 



. Milan 

. Rome 

. Venise 

. Naples 



Les instrumentistes regroupes par instruments (regroupement parvaleur 
de noeuds texte) 

Dans les deux exemples precedents, les valeurs servant de valeur de cle etaient des 
valeurs d'attributs. Ce n'est nullement une obligation : cet exemple va le montrer. 

On part d'un fichier XML comme ceci : 
Concert.xtnl 

p <?xml version="1.0" encocling="UTF-16" standal one="yes"?> 
<Concert> 



<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Mardi 11 Fevrier 2003, 20H30</Date> 
<Lieu>Chapelle des Llrsules</Lieu> 

<Enseinble> Hesperion XXI </Ensemble> 

<Interprete> 

<Nom> Jordi Savall </Nom> 

<Instrument>Dessus de viole</Instruinent> 
</Interprete> 

<Interprete> 

<Nom> Wieland Kuijken </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sophie Watillon </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sergi Casademunt </Noin> 
<Instrument>Tenor de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Noin> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
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<Interprete> 

<Noni> Marianne Muller </Noni> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Noni> Philippe Pierlot </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<TitreConcert> 

Fantasias for the Viols (1680) 
</TitreConcert> 

<Composi teur>Henry Purcel 1 </Composi teur> 
</Concert> 

Et on veut obtenir la distribution du concert, classee par instruments. Ici, les « valeurs » 
d'instruments sont leurs noms, qui ne sont pas des attributs, mais des noeuds texte. 

distribution.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/TransfDrm" version="1.0"> 

<xsl:output method^'text' encodings' ISO-8859-r /> 

<xsl :key name="groupesInterpretesParInstruments" 
match="Instrunient" 
use="." /> 

<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
================================================================== --> 

<xsl :variable name="lesDifferentsInstruments" 
sel ect="// Instrument [ 



generate-id( ) = 
generate-id( 

key( 'groupesInterpretesParlnstruments' , . )[1] 



]" /> 



<!-- 



> 



<xsl itemplate match="/"> 
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<!-- 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentsInstruments" > <!-- 
=============================================== --> 

<!-- 

ici le nffiud courant est un ncud <Instruinent> 
--> 

<xsl ivariable name="val eurCourante" select^"." /> 
- <xsl :val ue-of sel ect="$val eurCourante"/> 
<!-- 

Etape 2B : parcours des <Instruinent> ayant cette valeur 
==================================================== --> 

<xsl :for-each select="key( 'groupesInterpretesParlnstruments' , 

$val eurCourante) " > <!-- 
==================================================== --> 

<!-- 

ici le nffiud courant est un naud <Instruinent> 
--> 

<xsl ivariable naine="instrumentiste" 

select=". /parent: :Interprete" /> 
. <xsl :val ue-of select="$instruinentiste/Noin"/> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 



</xsl :stylesheet> 
Resultat 



Dessus de viole 
. Jordi Savall 



- Hautecontre de viole 

. Wieland Kuijken 
. Sophie Wati 1 1 on 

- Tenor de viole 

. Sergi Casademunt 

- Basse de viole 

. Sylvia Abramowicz 
. Marianne Muller 
. Philippe Pierlot 
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Les villes trois partrois (regroupement positionnel) 

Le probleme est tres simple : on a une liste de villes, et on veut les afficher sous la forme 
d'un tableau de trois colonnes par ligne. Nous reprenons done le memefichier que celui 
qui a servi pour regrouper les villes par pays : 

villes.xiiil 

<?xnil version="1.0" encocling="UTF-16" standalone="yes"?> 
<Villes> 

<Ville noni="Paris" pays="France" /> 

<Ville noin="Madrid" pays="Espagne" /> 

<Ville noin="Milan" pays="Ital ie" /> 

<Ville noin="Ronie" pays="Ital ie" /> 

<Ville noin="Angers" pays="France" /> 

<Ville noin="Barcelone" pays="Espagne" /> 

<Ville nom="Venise" pays="Italie" /> 

<Ville nom="Cordoue" pays="Espagne" /> 

<Ville noin="Naples" pays="Italie" /> 
</Villes> 

Le fichier a obtenir est le suivant : 



vi 11 es ■ html 

<htnil> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 



<title> Les villes </title> 
</head> 

<body text="black" bgcolor="white"> 
<table> 
<tr> 

<td>Paris</td> 
<td>Madrid</td> 
<td>Milan</td> 
</tr> 
<tr> 

<td>Ronie</td> 
<td>Angers</td> 
<td>Barcelone</td> 
</tr> 
<tr> 

<td>Venise</td> 
<td>Cordoue</td> 
<td>Naples</td> 
</tr> 
</table> 
</body> 
</html> 
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Le principe n'est pas different, malgre le fait que leregroupementsoitici positionnel : il 
suffit de se ramener a un poi nt de vue dans I equel I a val eur d'une vi 1 1 e est mai ntenant non 
plus son pays, maissa position au sein de lafratriedes villes. 

La premiere etape sera done comme d'liabitude de constituer une cle de regroupement 
par valeur. 

<xsl :key name="lesVillesParPosition" 
niatch="Vi 1 1 e" 
use="??" /> 

Neanmoins, le probleme est ici de definir la position de la ville courante, lors de reva- 
luation de I 'expression XPath fournie par I'attribut use, 

Remarque importante 

II feut ici se souvenir que cette expression XPath est evaluee avec le nceud en concordance comme noeud 
contexte, et une liste reduite au seul nceud contexte comme liste contexte. Si bien que la fonction predefinie 
position( ) ne peut que renvoyer la valeur 1, si on I'appelle quelque part au sein de cette expression. II faut 
done definitivement abandonner I'idee d'utiliser cette fonction dans une expression pour le calcul de la valeur 
d'une cle, si on I'avait jamais eue : une fonction qui renvoie toujours 1 n'est pas vraimentdes plus utiles. 

Ici, la liste interessante n'est done pas la liste contexte formee lors de I'evaluation de 
I'expression attribut de use, mais le node-set des <viiie>, enumere dans I'ordre de lec- 
ture du document, qui donne la numerotation (en partant arbitral rement de 0) 0 (Paris), 

I (Madrid) 8 (Naples). 

Pour une <viiie> donnee, son numero est done egal au nombre d'elements contenus 
dans le node-set des <vii ie> qui sont des preceding-si bi ing de la <vine> courante. Si 
done I'on evalue I'expression 

preceding-slbl ing: :Ville 

par rapport a un nceud contexte qui est une <vi n e> V quelconque, on obtient le node-set 
detoutes les villes situees avantV dans I'ordre de lecture du document. 

I'expression qui donne la position d'une telle <vine>V est done : 

count( preceding-sibling: :Ville ) 

si toutefois I'evaluation a bien lieu par rapport au nceud contexte V. 

II est done possible, maintenant, de determiner I'expression qui va fournir la valeur de 
regroupement des villes : 

<xsl :key name="l esVi 1 1 esParPosi ti on" 
niatch="Vi 1 1 e" 

use=''floor( count(preceding-sibling: :Ville) div 3 )" /> 

L'operateur div est la division ; les calculs sefaisant en nombres reels double precision, 
il est necessai rede prendre la partieentieredu quotient obtenu, d'ou I'appel a la fonction 

floorO, 
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Avec cette definition de cle : 

• les villes Paris, M adrid, et M ilan ont pour valeur 0 ; 

• les villes Rome, Angers, etBarcelone ont pour valeur 1 ; 

• les villes Venise, Cordoue, et Naples ont pour valeur 2, 

L'etape 1 consiste comme d'liabitude a constituer I'ensemble des elements de valeurs 
toutes differentes (ici des villes), mais c'est plus simple a realiser que dans les exemples 
precedents, car les villes qui vont constituer cet ensemble ont un numero que I'on peut 
calculer a I'avance : ce sont les villes numerotees 0 (Paris), 3 (Rome), et 6 (Venise), qui 
ont respectivement pour valeur 0, 1, et 2. L'initialisation de la variable contenant le node- 
set des villes de valeurs toutes differentes va done pouvoir s'ecrire : 

<xsl ivariable name="lesDifferentsGroupesDeVilles" 
select="//Ville[ 

((positionO - 1) mod 3) = 0 
]" /> 

Ici, la fonction posuiono peut etre utilisee, car elle est appelee dans un predicat qui 
filtre un node-set constitue de toutes les villes : lors de I'evaluation du predicat, la liste 
contexte est constitute des elements du node-set a filtrer, done la fonction posUiono 
renvoie la position de la ville courante au sein de cette liste, ce qui donne le resultat 
attend u. 

On peut done maintenantecrire I e programme, dontleplan reprendtresexactementcelui 
des autres exemples de regroupements que nous avons deja vus. 

villes.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'html ' encoding=' ISO-8859-r /> 

<xsl ivariable name="facteurDeRegroupement" select="3"/> 

<xsl :key name="lesVillesParPosition" 
match="Vi 1 1 e" 

use="floor( count(preceding-sibling: :Ville) div 3 )" /> 



<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 
===================================================== --> 

<xsl : variabl e name="l esDifferentsGroupesDeVil 1 es" 
select="//Ville[ 

((positionO - 1) mod $f acteurDeRegroupement) = 0 
]" /> 

<!-- 

====================== — ==== — ============= — ================== -> 
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<xsl itempl ate match="Villes"> 

<table> 
<!-- 

Etape 2A : parcours des valeurs de cet ensemble 
=============================================== --> 

<xsl :for-each select="$lesDifferentsGroupesDeVilles"> <!-- 
=============================================== --> 

<!-- 

ici le noeud courant est un noeud Ville 

(la premiere de chaque ligne du tableau) 

Sa valeur de cle est donnee par positionO - 1 

--> 

<xsl : vari abl e name="valCle" select="position() - 1" /> 

<tr> 
<!-- 

Etape 2B : parcours des noeuds ayant cette valeur 
========================================================= --> 

<xsl :for-each select="key( 'lesVillesParPosition' . $valCle)"> <!-- 
========================================================= --> 

<!-- 

ici le noeud courant est une ville 
--> 

<td><xsl :value-of select="@nom"/></td> 

</xsl :for-each> 

</tr> 
</xsl :for-each> 
</table> 

</xsl itempl ate> 

<!-- --> 

<xsl itemplate match="/"> 
<html> 
<head> 

<title> Les villes </title> 
</head> 

<body text="black" bgcol or="white"> 
<xsl : apply-templ ates/> 
</body> 
</html> 
</xsl itempl ate> 

</xsl :stylesheet> 

L e resultat obtenu est celui montre plus haut (fichier vi 1 1 es . htmi ) ; on observera le desa- 
grement que procure I 'interdiction d'utiliser une reference de variable dans I'attribut use 
de ^instruction xsi :key. 
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Regroupements hierarchiques 

Les regroupements hierarchiques consistent a reconstituer explicitement une hierarchie 
d'elements, absente du document a traiter, mais neanmoins sous-jacente. Au lieu d'etre 
veritablement arborescent, avec des elements imbriques, I e document est en effetgenera- 
lement reduit a une structure lineal re d'elements juxtaposes. C'est ce qui explique qu'un 
regroupement hierarchique ne soit pas sans rapport avec un regroupement positionnel, 
dans la mesure ou la reconstitution du niveau hierarchique d'un element est en partie 
basee sur sa position dans la structure lineal re. 

La valeur d'un element sera done ici la place hierarchique que I'element devra avoir dans 
le document resultat, ce qui est equivalent a dire que la valeur d'un element, c'est le 
noeud qu'il devrait avoir pour parent dans le document source. 

D'une fagon generale, on peut affirmer qu'on a identifie un probleme de regroupement 
hierarchique quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contientcertains noeuds N d'un certain type pour lesquels on dispose (au 
moins conceptuellement) d'une certaine fonction valeur, telle que vaieurCN) renvoie 
I'identite du noeud qui devrait etre le parent de N, si la hierarchie etait correctement 
respectee. 

2) Le document resultat doit contenir les noeuds N, reorganises (ou regroupes) de 
telle sorte que chaque noeud N ait pour parent un noeud dont I'identite est egale a 

val eur( N ) . 

Dans son principe, la solution consiste a proceder en deux etapes : 

• Etape 1 : on commence par une reconstitution des relations hierarchiques. Chaque 
noeud N a traiter estassocie par unecle a sa valeur hierarchique (I'identite du noeud qui 
devrait etre le parent de n). A la fin de cette operation, 11 est done possible d'obtenir le 
node-set des enfants directs de chaque noeud p du document : en effet, connaissant p, 
on connait son identite I (generate- i d ( )), et la cle donnealors tous les elements ayant 
I pour valeur, c'est-a-diretous les elements ayant p pour parent. 

• Etape 2 : on parcourtia hierarchie, en partantdu sommet, Connaissant le sommet, on 
en deduit les enfants qu'il devrait avoir, grace a la cle obtenue a I'etape precedente, et 
on les construit dans le document resultat. II n'y a plus qu'a reprendre ce processus, 
non pi us avec I e sommet, mais avec chacun des enfants, etainsi de suite recursivement 
avec tout le reste de la hierarchie. 

Exemple generique 

Cetexempleestun exemple simple et generique, qui revient assez souvent sousdiverses 
formes sur la mailing-listXSLT (www.biglist.com/lists/xsl-list/archives). 

Note 

On retrouvera cet exemple avec le moteurde recherche disponible a I'adresse ci-dessus : chercher « De-flatte- 
ning an XML tree ». 
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On part d'un fichier plat, comme ceci : 
flatDatas.xml 

[ <?xml version="1.0" encoding="LITF-16" ?> 
<recorclset> 
<record/> 
<data/> 
<data/> 
<record/> 

<data/> 
<record/> 
<data/> 
<data/> 
<data/> 
</recordset> 

et on veut reconstituer un fichier hierarchique, comme cela : 
Datas.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recordset> 
<record> 

<data/> 

<data/> 
</record> 
<record> 

<data/> 
</record> 
<record> 

<data/> 

<data/> 

<data/> 
</record> 
</recordset> 

Premiere etape 

Dans la premiere etape, il s'agit de reconstituer la hierarchie sous-jacente. L'idee est 
done de rattacher chaque element a son parent : les <record> doivent etre rattaches au 
<recordset>, et cliaque <data> au premier <record> qui apparait dans le sens inverse de 
celui de la lecture du document. Pour cela, on va affecter a chaque element une valeur 
egale a I'identite de son parent potentiel, et maintenir cette information grace a une cle, 
dont on peut voir la structure a la figure 9-3. 

La figure 9-3 montre la structure plate du fichier XML, et comment retrouver les enfants 
directs d'un noeud : par exemple le <record> A correspond a la valeur VA, qui est la 
valeur du nceud <data> B, ce qui signifie que le <record> A a pour enfant I'element 
<data> B. De meme, le noeud <recordset> Correspond a la valeur VRS, qui est la valeur 
des trois noeuds <record>, ce qui signifie que le <recordset> a pour enfants les trois 
<record>. Bien sur, cette derniere valeur decle est redondanteavec la structure memede 
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I'arbre X M L de depart, qui donne deja cette information, mais il est plus simple de gar- 
der cette redondance pour regulariser la structure du programme, qui pourra ainsi tou- 
jours passer par la cle pour obtenir les enfants directs d'un noeud. 




Figure 9-3 

Cle pour retrouver les enfants directs d'un nceud. 



Les elements <data> ne correspondent a aucune valeur, parce qu'ils n'ont pas d'enfants 
directs. 

En resume, si I'on considere I'ensemble des valeurs, et que I'on y choisit une valeur V 
quelconque, on peut dire que : 

• V correspond a un (et un seul) nceud N ; 

• V est la valeur d'un ensemble denceudsE. 

On saitalors que le nceud N devrait avoir les nceudsE pour enfants. C'est pourquoi la cle 

est nommee "l esEnfantsOl rects". 

Unefoisqu'on a vu la structure de la cle a obtenir, il n'y a plusqu'a trouver comment ini- 
tialiser. Partant d'un element E quelconque dans ledocumentoriginal, il s'agitde determiner 
son parent potenti el, etd'associeraE une valeur qui est I'identifiantdece parent potentiel. 
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Mais il y a deux types d'elements dont il faut trouver les parents : les <data> et les 
<record>. Pour un Hoeud <data>, il faut reclierclier le premier <record> en remontant 
vers la racine du document, et la valeur associee est dans ce cas I'identifiant de ce 
<record>. M ais pour un noeud <record>, il faut prendre le parent <recorset>, et I'identi- 
fiant de ce <recordset> est alors la valeur du noeud <record>. 

On est done dans un cas ou la cle doit etre constitute en deux fois: une premiere 
declaration pour le parent des noeuds <record>, et une deuxieme pour les parents des 
noeuds <data>, comme ceci : 

Premiere etape : initialisation de la de des enfants directs 

<xsl : key 

nanie="l esEnfantsDi rects" 
match="record" 

use="generate-id( parent: : recordset )" /> 

<xsl : key 

nanie="l esEnfantsDi rects" 
match="data" 

use="generate-id( preceding-sibling: :record[l] )" /> 

Cette fagon de constituer une meme cle en deux fois est parfaitement autorisee, et le 
resultat est conforme a ce que montre la figure 9-3. 

Deuxieme etape 

La deuxieme etape est une etape de parcours recursif de la hierarchie memorisee dans la 
cle. U n tel parcours a une structure extremement regul iere que I 'on retrouvera a I 'identique 
dans tous les problemes de regroupements hierarchiques. 

On commence par le sommet de la hierarchie : 

Deuxieme etape : parcours hierarchique (debut) 

<xsl :templ ate match="recordset" > 
<recordset> 

<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</recordset> 
</xsl :templ ate> 

Ici, I'on construit I 'element <recordset> en lui affectant pour enfants ceux que va nous 
donner la cle pour la valeur correspondant a I'identifiant du noeud courant, c'est-a-dire le 

<recordset>. 

Les enfants du <recordset> etant des <record>, il suffit maintenant d'ecrire une regie 

pour les <record> : 

Deuxieme etape : parcours hierarchique (suite) 

|<xsl :templ ate match="record" > 
<record> 
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<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 

</recorcl> 
</xsl :templ ate> 

Les enfants d'un element <record> etant des <data>, qui sont des elements terminaux de 
la hierarchie, on va cettefoisecrire pour les elements <data> une regie non recursive, qui 
se contentera de recopier cet element dans le document resultat. 

On peut done maintenant donner le programme complet : 

unflatten.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='xnil ' encoding=' ISO-8859-1 ' indentures' /> 
<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl : key name="l esEnfantsDi rects" 
inatch="record" 

use="generate-1d( parent: : recordset )" /> 

<xsl : key 

naine="l esEnfantsDi rects" 
match="data" 

use="generate-id( preceding-sibling: :record[l] )" /> 

<!-- 



Parcours recursif de la hierarchie 



--> 



<xs1 : tempi ate match="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl :template match="recordset" > 
<recordset> 

<xsl :apply-teinplates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</recordset> 
</xsl :templ ate> 
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<xsl itempl ate match="record" > 
<record> 

<xsl lapply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' . generate- id( .))"/> 

</record> 
</xsl itempl ate> 

<!-- 



Elements terminaux de la hierarchie 



--> 

<xsl itempl ate match="data" > 
<xslicopy-of select="."/> 
</xsl itempl ate> 



</xsl istylesheet> 

Reconstitution hierarchique d'un texte 

Le programme que I'on vient de voir s'appliquait a un exemple tres simple, comportant 
une iiierarcliie presque triviale. Nous allons maintenant voir que si I'on s'attaque a la 
reconstruction d'une hierarchie beaucoup plus complexe, cela ne change rien a la struc- 
ture du programme, que I'on va done pouvoir reprendre integralement du programme 
precedent. Par contre, cequi peutdevenir un peu complique, c'estd'exprimer les concor- 
dances de motifs adequates pour les initialisations des valeurs de la cle, 

Le probleme est maintenant de transformer un document XM L representant un texte 
(typiquement un livre ou un article), structure en chapitres, sections, etc., pour passer 
d'une representation plate a une representation hierarchique. Ce genre de probleme 
peut eventuellement se poser quand on veut adapter un texte existant a une nouvelle 
DTD. 

Ce probleme revient assez souvent et sous di verses formes sur la mailing-list XSLT : faire 
une recherche de « transforming an incorrectly structured document » sur www.google.fr , 
par exemple. 

Nous partirons de I'exemple suivant, assez representatif du probleme : 
texte .xinl 

<?xml version="1.0" encoding="UTF-16" ?> 
<document> 

<titreSectionl> titre A </titreSectionl> 
<p> para 1 </p> 

<titreSection2> titre A.l </titreSection2> 
<p> para 2 </p> 
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<p> para 3 </p> 
<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 
<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </t1treSect1onl> 

<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.1.1 </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 

</docuinent> 

indentation permet de mieux apprehender la structure du texte, mais il faut bien voir 
qu'il n'y a ici aucune imbrication d'elements. 

On veutecri re une transformation qui aboutissea ceci : 



texteReconstruit.xml 

<?xnil version="1.0" encocling="IS0-8859-l"?> 
<Document> 
<Sect1onl> 

<t1tre> titre A </titre> 
<p> para 1 </p> 
<Section2> 

<titre> titre A.l </titre> 
<p> para 2 </p> 
<p> para 3 </p> 
<p> para 4 </p> 
</Section2> 
<Section2> 

<titre> titre A. 2 </titre> 
<p> para 5 </p> 
<Section3> 

<titre> titre A. 2.1 </t1tre> 
<p> para 6 </p> 
<p> para 7 </p> 
</Sect1on3> 
</Section2> 
<Section2> 

<titre> titre A. 3 </titre> 
<p> para 8 </p> 
</Section2> 
</Sectionl> 
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<Sectionl> 

<titre> titre B </titre> 
<Section2> 

<titre> titre B.l </titre> 
<Section3> 

<titre> titre B.1.1 </titre> 
<p> para 9 </p> 
</Section3> 
<Section3> 

<titre> titre B.l. 2 </titre> 
<p> para 10 </p> 
</Section3> 
</Section2> 
<Section2> 

<titre> titre B.2 </titre> 
<p> para 11 </p> 
</Section2> 
</Sectionl> 
</Document> 



Le programme general de reconstruction d'une hierarchie etant applicable ici, nous 
pouvons done tout de suite I'ecrire, en laissant en blanc I'initialisation de la cle : 



Ebauche de la transformation 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" versiDn="1.0"> 
<xsl:output method^'xmr encodings' ISO-8859-r indent^'yes' /> 
<!-- 

Reconstitution des relations hierarchiques 

--> 

<xsl :key name="l esEnf antsDi rects" 
niatch="??" 
use="??" /> 

<xsl : key . . . /> 
<!-- 

Parcours recursif de la hierarchie 
--> 



<xsl itempl ate match="/"> 
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<xsl lapply-templates /> 
</xsl :templ ate> 

<xsl : tempi ate niatch="docuinent" > 
<Docuinent> 

<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 
</Docunient> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select="."/></titre> 
<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- icl( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl :template match="titreSection2" > 
<Section2> 

<titre><xsl :value-of sel ect=" . "/></titre> 
<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , gene rate- id( .))"/> 
</Section2> 
</xsl itempl ate> 

<xsl :template match="titreSection3" > 
<Section3> 

<titre><xsl :value-of select="."/></titre> 
<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Section3> 
</xsl :templ ate> 



<!-- 



Elements terminaux de la hierarchie 



--> 



<xsl :templ ate match="p" > 
<P> 

<xsl :val ue-of select="."/> 

</p> 
</xsl itempl ate> 



</xsl :stylesheet> 



On voit combien le programme est semblable au precedent, du moins pour ce qui est de 
I'etape 2, ou I'on doitfaire un parcours recursif de la hierarchie. 
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Pour etablir I'initialisation correcte de la cle, il faut tout d'abord determiner la structure 
hierarchique possible, c'est-a-dire en fait la DTD du document resultat. II n'est pas 
necessaire de formaliser cela sous la forme d'une vraie DTD, il suffit ici de dire que : 

• un <Document> peut avoir pour enfants des <sectioni> ; 

• une <sectioni> peut avoir pour enfants des <p> ou des <section2> ; 

• une <section2> peut avoir pour enfants des <p> ou des <section3> ; 

• une <section3> peut avoir pour enfants des <p>. 

Le probleme etant de redonner a chaque element le parent qu'il devrait avoir dans la 
future hierarchi e, i I faut done inverser la relation « a pour enfant » dans la listeci-dessus : 

• un <titreSectioni> devrait avoir pour parent I'element <document> ; 

• un <titreSection2> OU un <p>#i devrait avoir pour parent I'element <titreSectioni> 
[-1] ; 

• un <titreSection3> OU un <p>#2 devrait avoir pour parent I'element <titreSection2> 
[-1] ; 

• un <p>#3 devraitavoirpourparentl'element<titreSection3>[-i]. 

La notation <p>#i designeici un element <p> qui esttel que si on remontedepuiscet ele- 
ment <p> vers la racine du document, le premier element rencontre qui ne soit pas un <p> 
est un <titreSectioni>. II en va de memeavec <p>#2 et <titreSection2>, avec <p>#3 et 

<ti treSecti on3>. 

La notation <titreSectioni>[-i] designe le premier <titreSectioni> rencontre en 
remontant depuis le noeud contexte vers la racine, ce qui s'exprime techniquement par 
une expression XPath tres classique : 

preceding-sibl ing: :titreSectionl[l] 

On a lememe genre d'expression avec <titreSection2>[-i] et <titreSection3>[-i], 

La seule reelle difficulte de ce programme reside dans I'ecriture d'un motif exprimant la 
notation <p>#n. M ais en procedant progressivement, depuis un node-set contenant tous 
les elements <p> sans distinction, que I'on filtre en enchainant les predicats adequats, on 
parvient au resultat cherche. 

Voyonscelasurlecasde<p>#i ; il faut partirde tous les elements <p> : 

p 

On ne retientqueceux dont I'axe preceding-si bi ing, reduitaux elements non <p>, n'est 
pas vide : 

p[preceding-sibl ing: :*[not(self::p)]] 

Maintenant, on ne retientque ceux dont I'axe preceding-sibi ing, reduitaux elements 
non <p>, n'est pas vide etpossedeun premier element qui estun <titreSectioni> : 

p[preceding-sibl ing: :*[not(self::p)][l][self: :ti treSecti onl]] 
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A rrive a ce stade, on a de quoi initialiser parti ellement la cle ; on reprend par exemple le 
deuxieme item de I 'enumeration ci-dessus : 

• un <titreSection2> ou un <p>#i devrait avoir pour parent I 'element <titreSectioni> 
[-1] ; 

II suffit detranscri re cette phrase en initialisation decle : 



naine="lesEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :* [not (self: :p)][l][self: :titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

Des lors, on a tout ce qu'il faut pour terminer le programme completement : 
texte.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xinlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output inethod='xnil ' encoding=' ISO-8859-1 ' indent^'yes' /> 



<xsl : key name="l esEnfantsDi rects" 
match="titreSectionl" 
use="generate-id( parent: :document )" /> 

<xsl : key 

naine="l esEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :*[not(self : :p)][l][self: :titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 



<xsl : key 



<!-- 



Reconstitution des relations hierarchiques 



--> 



<xsl : key 



name="l esEnfantsDi rects" 
match="titreSection3 | 



p[preceding-sibl ing: 
use="generate-id( preceding 



*[not(self : :p)][l][self : :titreSection2]]" 
sibl ing: :titreSection2[l] )" /> 



<xsl : key 



naine="l esEnfantsDi rects" 
match="p[preceding-sibl ing: 
use="generate-id( preceding 



*[not(self : :p)][l][self : :titreSection3]]" 
sibl ing: :titreSection3[l] )" /> 



<!-- 
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Parcours recursif de la hierarchie 



<xsl :templ ate match="/"> 

<xsl lapply-templates /> 
</xsl :templ ate> 

<xsl itempl ate match="docunient" > 
<Document> 

<xsl lapply-templates 

select="key( ' 1 esEnfantsDi rects ' , generate-id( . ))"/> 
</Document> 
</xsl :template> 

<xsl itemplate match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select="."/></titre> 
<xsl lapply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl itempl ate match="titreSection2" > 
<Section2> 

<titre><xsl :value-of select="."/></titre> 
<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , genera te-id( .))"/> 
</Section2> 
</xsl itempl ate> 

<xsl itemplate match="titreSection3" > 
<Section3> 

<titre><xsl ivalue-of select="."/></titre> 
<xsl I apply-templ ates 

select="key( ' 1 esEnfantsDi rects ' . generate-id( . ))"/> 
</Section3> 
</xsl itempl ate> 



<!- 



Elements terminaux de la hierarchie 



<xsl itempl ate match="p" > 
<P> 
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<xsl :val ue-of select="."/> 

</p> 
</xsl itempl ate> 



</xsl :stylesheet> 

Le resultat est conformea ceque I 'on a montre au tout debut. 

M aintenant, la question que I 'on pourraitse poser concerne la disproportion entre la fai- 
ble variete des elements termi naux (uni quement des <p>), et la complexite i mportante des 
motifs de cle. Si I 'on a un texte plus riche en elements termi naux, que va-t-il advenir de 
ces motifs? 

Supposons par exemple qu'il puissey avoir des <figure> en plus des <p>, commececi : 
texte .xtnl 

<?xml version="1.0" encocling="UTF-16" ?> 
<document> 

<titreSectionl> titre A </titreSectionl> 
<p> para 1 </p> 
<figure href="A.gif"/> 
<titreSection2> titre A.l </titreSection2> 

<p> para 2 </p> 

<p> para 3 </p> 

<figure href="A.l.gif"/> 

<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 

<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<figure href="A.2.1.gif"/> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </t1treSect1onl> 
<figure href="B.gif"/> 
<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.1.1 </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 
<figLire href="B.2.g1f "/> 

</docuinent> 

L'lnltlailsatlon partielle de la cle prend alors la forme suivante : 

<xsl : key 

naine="lesEnfantsDi rects" 
match="titreSection2 | 
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*[self::p or self : :figure] 
[preceding-si bl ing: :* 

[notCself : :p)] 

[not(self : :figure)] 

[1] 

[self: :titreSectionl] 

]" 

use="generate-icl( preceding-sibl ing: :titreSectionl[l] )" /> 

Comparez avec I'initialisation lorsque<p> estleseul element terminal : 

<xsl : key 

nanie="l esEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibl ing: :*[not(self : :p)][l][sel f : : titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On peut ameliorer la comparaison en recrivant cette initialisation de la meme fafon : 

<xsl : key 

name="l esEnfantsDi rects" 
match="titreSection2 | 
*[self: :p] 

[preceding-sibl ing: :* 
[not(self::p)] 
[1] 

[self: :titreSectionl] 

]" 

use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On voit done comment evolue le motif lorsqu'on ajoute des elements terminaux possi- 
bles : globalement, le motif se complexifie, mais sa structure reste tres reguliere, ce qui 
permet done d' envi sager de transformer des textes pi us ri ches que ceux que I ' on a montre 
en exemple. 

Le reste du programme (I'etape 2) reste inchangee dans sa structure: leseul end roit deli cat 
est I'ecriture des motifs. 

texte.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" version="1.0"> 
<xsl:output method^'xml ' encoding=' ISO-8859-r indent^'yes' /> 

<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl :key name="l esEnfantsDi rects" 
niatch="titreSectionr' 
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use="generate-id( parent: :document )" /> 



<xsl : key 

naine="l es Enfant sDi rects" 
match="titreSection2 | 

*[self::p or self : ifigure] 
[preceding-sibling: :* 
[not(self : :p)] 
[not(self : ifigure)] 
[1] 

[self: :titreSectionl] 

]" 

use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

<xsl : key 

name="l es Enfant sDi rects" 
match="titreSection3 | 

*[self::p or self : :figure] 
[preceding-sibling: :* 
[not(self : :p)] 
[not(self : :figure)] 
[1] 

[self: :titreSection2] 

]" 

use="generate-id( preceding-sibl ing: :titreSection2[l] )" /> 

<xsl : key 

naine="l es Enfant sDi rects" 
match="*[self : :p or self : :figure] 
[preceding-sibl ing: :*[ 
notCself : :p)] 
[not(self : :figure)] 
[1] 

[self: :titreSection3] 

]" 

use="generate-id( preceding-sibl ing: :titreSection3[l] )" /> 



<!- 



Parcours recursif de la hierarchie 



--> 



<xsl :templ ate rtiatch="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl : tempi ate match="docuinent" > 
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<document> 

<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , gene rate- id( .))"/> 
</document> 
</xsl :templ ate> 

<xsl itempl ate match="titreSectionl" > 
<Sectionl> 

<titre><xsl :value-of select="."/></titre> 
<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl itempl ate match="titreSection2" > 
<Section2> 

<titre><xsl :value-of select="."/></titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sect1on2> 
</xsl :templ ate> 

<xsl itempl ate match="t1treSect1on3" > 
<Section3> 

<t1tre><xsl :value-of select="."/></titre> 
<xsl :apply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 
</Sect1on3> 
</xsl :templ ate> 

<!-- 



Elements terminaux de la hlerarchie 



--> 

<xsl itempl ate match="p" > 
<P> 

<xsl : val ue-of select="."/> 

</p> 
</xsl itempl ate> 

<xsl itempl ate match="f1gure" > 
<xslicopy-of select="."/> 
</xsl itempl ate> 



</xsl istylesheet> 
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Exemple atypique 

Nous allons maintenant voir un exemple beaucoup plus simple, mais un peu atypique, 
afin de verifier que la structure generale d'un programme de reconstruction hierarchique 
tient debout malgre le changement de contexte destabilisant. 

II s'agit du fichier company. xmi, evoque au debut decette section sur les regroupements : 

cotnpany.xml 

<?xnil version="1.0" encoding="UTF-16"?> 
<table name="COMPANY"> 

N0ACA<tab/>CHAR(6)<br/> 

LSACAl<tab/>VARCHAR2(35)<br/> 

CCPAAl<tab/>NUMBER(4)<br/> 

LAACAl<tab/>VARCHAR2(35)<br/> 

URL<tab/>VARCHAR2(40)<br/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 
</table> 

restoredCoinpany.xtiil 

<?xnil version="1.0" encoding="IS0-8859-l"?> 
<table name="COMPANY"> 
<field> 

<name>NOACA</name> 

<type>CHAR(6)</type> 
</field> 
<field> 

<name>LSACAl</nanie> 

<type>VARCHAR2(35)</type> 
</field> 
<field> 

<name>CCPAAl</name> 

<type>NUMBER(4)</type> 
</field> 
<fie1d> 

<name>LAACAl</name> 

<type>VARCHAR2(35)</type> 
</field> 
<field> 

<name>URL</name> 

<type>VARCHAR2(40)</type> 
</field> 
<field> 

<name>STATRAT</name> 

<type>VARCHAR2(l)</type> 
</field> 
</table> 

Ce qui est atypique, ici, c'est que ce sont les elements <tab> qui sont les elements de 
deuxieme niveau, rattaches aux elements <br>, alors qu'ils sont places avant. Bien que 



Patterns de transformation 

Chapitre 9 

cela change un peu de I'habitude, la structure generale du programme de transformation 
reste i ntacte : 

restoredCompany .xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" versiDn="1.0"> 
<xsl:output method^'xml ' encodings' ISO-8859-r indent^'yes' /> 
<!-- 



Reconstitution des relations hierarchiques 



--> 

<xsl :key name="l esEnf antsDi rects" 
niatch="br" 

use="generate-id( parent: :table )" /> 

<xsl : key 

name="l esEnfantsDi rects" 
match="tab" 

use="generate-id( fol 1 owing-sibl ing: :br[l] )" /> 



<!-- 



Parcours recursif de la hierarchie 



--> 



<xsl itempl ate match="/"> 

<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl itempl ate match="table" > 
<xsl :copy> 

<xsl :for-each select="attribute: :*"> 

<xsl :copy/> 
</xsl :for-each> 

<xsl :apply-templates 

sel ect="key( ' 1 esEnfantsDi rects ' , generate-id( .))"/> 

</xsl :copy> 
</xsl :templ ate> 



<xsl itempl ate match="br" > 
<field> 
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<xsl lapply-templates 

sel ect="key ( ' 1 esEnfantsDi rects ' , generate- id( .))"/> 
<type><xsl : val ue-of sel ect="preceding-sibl ing: : text( ) [l]"/></type> 
</field> 
</xsl :templ ate> 

<!-- 



Elements terminaux de la hierarchie 



--> 

<xsl :template match="tab" > 
<name> 

<xsl : val ue-of sel ect=" normal ize-space(preceding-sibl ing: :text( )[!])"/> 
</name> 
</xsl itempl ate> 



</xsl :stylesheet> 

Leresultatobtenu estlefichier restoredcompany.xmi montre ci-dessus, 

Pattern n° 15 - Generation d'une feuille de style par une autre 
feuille de style 

Motivation 

II y a descas (a priori assez rares) ou Ton tombesur des limitations du langageXSLT lui 
meme : par example, I e fait que seulement certains attributs soient susceptibles d'accep- 
terdesdescripteursdevaleursdiffereesd'attributs; ou bien le fait qu' une expression ne 
puisse pas etre construite puis interpretee dynamiquement. 

Une solution, lorsque I'on est confronts a cette difficulte, consiste a utiliser telle ou telle 
extension proposee par tel ou tel processeur. Mais cette solution, en general, rend le 
programme non portable, ce qui peut ne pas etre acceptable dans certains cas. 

Une autre solution consiste a ecrire une feuille de style qui genere une autre feuille de 
style. 

L'une des difficultes de la mise en oeuvre d'une feuille de style qui en genere une autre, 
est que la feuille de style va contenir des instructions litterales a produire dans le docu- 
ment resultat ; mais 11 ne faut pas que le processeur X SLT s'apergoive que ces elements 
XML sontdesinstructionsXSLT, sinon il va tenter de I es executer. C'estlaqu'intervient 
instruction namespace-ai ias, qui permet de produire dans le document resultat des ele- 
ments XM L dans un domaine nominal different de celui qu'ils avaient dans la feuille de 
style primitive. 
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Une autre difficulte peutaussi survenir, inattendue : c'estqu'unefeuillede style generee, 
c'estbien ; mais une feuillede style generee etexecutee, c'estmieux. 

II est done assez probable qu'en plus de generer la feuille de style, on veuille generer 
un fichier de commande pour lancer I 'execution de cette feuille de style generee avec 
les bons arguments. Se pose des lors le probleme d'etre capable de produire plus 
d'un fichier resultat. C'est en principe infaisable en XSLT 1.0 ; mais le besoin etant 
reel, des extensions existent avec la plupart des processeurs XSLT pour permettre la 
production de plusieurs documents resultat. De son c6te, le « Working Draft » 
XSLT 1.1 propose d'ajouter une instruction xsi :document, (et cette proposition a ete 
reprise dans le Working Draft 2.0) dont I'effet sera de permettre la production de 
plusieurs documents. 



L'exempleque nous allons voir est la realisation d'un petit interpreteurX Path : une feuille 
de style qui prend en donnee un fichier XML d'essai, et un fichier XML contenant des 
expressions XPath. La feuille de style a ecrire devra generer une feuille de style capable 
d'evaluer les expressions XPath sur le fichier d'essai. 

Void tout d'abord ces deux fichiers XML: 

BaseProduits.xtnl 

<?xml version="1.0" encoding="LITF-16"?> 
<BaseProduits> 

<LesProduits> 



<Livre ref="vernesl" NoISBN="193335" gainnie="roman" inedia="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" inonnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boi 1 eaunarcejacl" NoISBN="533791" ganime="roinan" 

media="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 

<Enregistrement ref="niaraisl" RefEditeur="LC000280" 




Exemple 



gamme="viol edegambe" media="CD"> 



<refOeuvres> 

<Ref valeur="marais.folies"/> 
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<Ref val eur="marais .piecesl685"/> 
</refOeuvres> 
<Interpretes> 

<Interprete noni="Jonathan Dunford"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Sylvia Abraiiiowic2"> 

<Role xml :1 ang="fr"> Basse de viole </Role> 
<Role xml : 1 ang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete nom="Benjamin Perrot"> 

<Role xml :lang="fr"> Theorbe et guitare baroque </Role> 
<Role xml :1 ang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Stephane Fuget"> 

<Role xml :1 ang="fr"> Clavecin </Role> 
<Role xml : 1 ang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 
<Titre 

xml : 1 ang="f r"> Les Folies d'Espagne et pieces inedites </Titre> 
<Titre 

xml : 1 ang="en"> Folies d'Espagne and unedited music </Titre> 
<Prix val eur^'HO" monnaie="FF"/> 
<Prix valeur^-lS" monnaie=''£"/> 
</Enregistrement> 

<Materiel ref=''HarKarl'' refConstructeur^-XL-FZlBSBK" gamme="lecteurCD" 

marque="HarKar"> 

<refCaracteristiques> 

<Ref val eur="caracHarKarr7> 
</refCaracteri stiques> 
<Prix val eur=''4500'' monnaie="FF"/> 
<Prix valeur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<LesOeuvres> 

</LesOeuvres> 

<LesAuteurs> 

</LesAuteurs> 

<LesGammes> 

</LesGammes> 
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<LesMarqLies> 
</LesMarques> 
<LesCaracteri stiques> 
</LesCaracteri stiques> 
</BaseProcluits> 

XPath Express ions .xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Expressions sourceFi 1 e="BaseProclui ts.xml "> 

<XPath 
id="l" 

contextNode="Enregistrement" 

expression="descendant: : Interprete[attribute: :nom = 

'Sylvia Abramowicz']/child: iRole" 

/> 

<XPath 
id="2" 

context Node^" En regi St rement" 

expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 



<XPath 
id="3" 

context Node="BaseProdu1ts" 

expression="descendant: : Livre[attribute: : ref = 'vernesl']/ 

child: :Prix/attr1bute: :valeur'' 

/> 

<XPath 
id="4'' 

contextNode="Enreg1strement" 

expression="descendant: :Titre[attribute: :xml :lang = 'en']" 

/> 

<XPath 
id="5" 

context Node="BaseProdu1ts" 

expression="descendant: : Livre[attribute: : ref = 'vernesl']/ 

child: :Prix[attr1bute: :monnaie = ' FF' ]/attr1bute: :valeur" 

/> 

</Expressions> 
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Le but est done d'ecrire une feuille de style xpathinterpretor .xsi telle que le lancement : 

Ligne de comtnande 

I xpath XPathExpressions.xml 

produise le resultat suivant : 

Resultat 

=== id = 1 === 

{ 

-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[attribute: :nom = 

'Syl via Abramowi cz' ] /child: : Role" 

Basse de viole 
Bass Viol 



} 

=== id = 2 === 
{ 

-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[position( ) = 2] /attribute: inom" 
Sylvia Abramowi cz 




contextNode="BaseProduits" 

expression="descendant : : Li vre[attribute: : ref = 'vernesl']/ 

child: :Prix/attribute: :valeur" 

40.5 




{ 

-- contextNode="Enregi strement" 

-- expression="descendant: :Titre[attribute: :xml :lang = 'en']" 
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Folies d'Espagne and unedited music 



} 

=== id = 5 === 
{ 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix[attribute: imonnaie = 'FF']/attribute: ivaleur" 

40.5 



} 

La commande de lancement que nous venons de voir ne prend en donnee que le nom 
du fichierXM L contenantles expressions a interpreter (qui lui memefournit le nom du 
ficliierXM L a utilisercommejeu d'essai pour lesevaluationsXPatli). Cettecommande 
est en fait un script qui lance le processeur XSLT (Saxon, en I'occurrence), comme 
ceci : 

script Xpath 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 

com. i cl .saxon. Stylesheet -o XPathExpressions.xsl 
XPathExpressI ons . xml . ./XPathlnterpretor.xsl 

call temp. bat 

Dans ce script, seul le nom de ficliier en gras est un argument ; tout le reste est constant. 

La feuille de style xpathinterpretor.xsi genere la feuille de style xpathExpres- 
sions.xsi ainsi que lescript temp. batappelealafin. 

script temp .bat 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon.jar;" 

com. icl .saxon. Stylesheet -o out. memo 
BaseProdults.xml XPathExpressions .xsl 

Dans ce script, seul le nom de fichier en gras est un argument ; tout le reste est constant. 

Quant a la feuille de style generee, la voici, legerement retouchee dans sa presentation 
pour les besoins de la mise en page : 

XPathExpressions .xsl 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<aaa: stylesheet xml ns:aaa=" http://www.w3.org/1999/XSL/Transform" xmlns:xsl= 
"http://www.w3.org/1999/XSL/Transform" version="l .0"> 
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<aaa:output method="text" encoding="IS0-8859-l"/> 

<-- ========================= 1 =========================== --> 

<aaa: tempi ate inatch="/"> 
= id = 1 =-= 

<aaa : apply- tempi ates mode="Ml"/> 

- id = 2 === 

<aaa : apply- tempi ates mode="M2"/> 

- id = 3 === 

<aaa : apply- tempi ates mode="M3"/> 

. id = 4 === 

<aa a : apply- tempi ates mode="M4"/> 

- id = 5 === 

<aa a : apply- tempi ates mode="M5"/> 
</aaa:template> 

<-- ==========.=...=...=...== 1 =========================== --> 



<-- ========================= 2 =========================== --> 

<aaa:template match="text( )" mode="Mr7> 
<aaa:template match="text( )" mode="M2"/> 
<aaa:template match="text( )" mode="M3"/> 
<aaa:template match="text( ) " mode="M4"/> 
<aaa:template match="text( )" mode="M5"/> 

<-- ========================= 2 =========================== --> 



<-- ========================= 3 =========================== --> 

<aaa:template match="Enregi strement" mode="Ml"> 

-- contextNode=" En regi strement" 

-- expression="descendant: : Interprete[attribute: mom = 

'Sylvia Abramowicz']/child: :Role" 
<aaa :for-each sel ect= "descendant: : Interprete[ 

attribute: :nom = 'Sylvia Abramowi cz' ]/chi Id: : Role"> 
<aaa:value-of select="."/> 

</aaa:for-each> 

</aaa:template> 

<! > 

<aaa:template match="Enregi strement" mode="M2"> 
-- contextNode="Enregi strement" 

-- expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 
<aaa :for-each sel ect= "descendant: : Interprete[ 

positionO = 2] /attribute: :nom"> 

<aaa:value-of select="."/> 
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</aaa:for-each> 

} 

</aaa itempl ate> 

<! > 

<aaa itempl ate inatch="BaseProcluits" mode="M3"> 

{ 

-- contextNode="BaseProcluits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix/attribute: ivaleur" 

<aaa :for-each select=" descendant: : Li vre[ 

attribute: :ref = 'vernesl']/child: :Prix/attribute: :valeur"> 
<aaa:value-of select="."/> 

</aaa:for-each> 

} 

</aaa :templ ate> 

<! > 

<aaa:teniplate niatch="Enregistrement" inode="M4"> 

{ 

-- contextNode="Enregi strement" 

-- expression="descendant: :Titre[attribute: :xnil :lang = 'en']" 

<aaa:for-each select="descendant: :Titre[attribute: :xml :lang = 'en']"> 
<aaa:value-of select='' . "/> 

</aaa:for-each> 

} 

</aaa :templ ate> 

<! > 

<aaa: tempi ate match^'BaseProduits" mode=''M5"> 

{ 

-- contextNode="BaseProduits'' 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix[attribute: :monna1e = 'FF']/attribute: :valeur" 
<aaa:for-each select=''descendant : : Li vre[attribute: : ref = 

'vernesl'] /child: :Prix[ attribute: :monnaie = 'FF'] /attribute: :valeur"> 
<aaa:value-of select="."/> 

</aaa:for-each> 

} 

</aaa :templ ate> 

<-- ========================= 3 ========= — =============== -> 

</aaa:stylesheet> 
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Comme nous I'avons deja dit, I'un des problemes pour generer une telle feuille de style 
est la presence d' instructions litterales XSLT a emettre dans le document resultat. Par 
exemple, la section 2 ci dessus est generee par le fragment decode suivant : 

<!-- 2 --> 

<xsl :for-each sel ect="XPath"> 
<aaa:template> 

<xsl rattribute name="match">text( X/xsl :attribute> 

<xsl rattribute name="niode">M<xsl :value-of select="@id"/></xsl :attribute> 
</aaa :templ ate> 
</xsl :for-each> 
<!-- II --> 

On voit que I 'instruction template litterale est dans un domaine nominal prefixe par aaa, 
et different de celui d'XSLT, afin qu'elle ne soit pas prise pour une instruction XSLT a 
executer. 

Ceci implique bien sur de declarer le domaine nominal aaa, comme ceci : 

<xsl istylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforin" 
xmlnsiaaa = "http://machin" 
version = "1.0"> 

Le domaine nominal prefixe par aaa n'a aucune importance, n'importe quoi convient 
pourvu que ce ne soit pas "http://www.w3.org/i999/xsL/Transform". Le choix de 
"aaa" peut paraitre un peu bizarre, mais on a interet a choisir un prefixe qui s'oppose 
visuellement a "xsi ", sinon la feuille de style devient inextricable a relire. 

II faut de plus que dans le document resultat, les instructions XSLT (prefixees par aaa), 
soient dans le domaine nominal d'XSLT. C'est la qu'intervient ['instruction namespace- 
aiias,qui permet la transposition : 

I <xsl :namespace-alias styl esheet-pref ix="aaa" resul t-prefix="xsr7> 

Encore unefois, notons que les domaines nominaux sont references par leur prefixes, et 
done que cette instruction ne demande pas a changer le prefixe dans le resultat, mais a 
changer I e domai ne nomi nal associe au prefixe. E n cl ai r, on demande que dans I e resul tat, 
le domaine nominal associe a aaa ne soit plus soit "http://machin", mais celui qui est 
actuel lement associe a xsi . 

Le resultat est visible ci-dessus : la feuille de style generee contient des instructions XSLT 

prefixees par aaa, maiS ce prefixe est bien celui de "http://www.w3.org/1999/XSL/Trans- 

f orm", tout est donc correct pour que la feuille de style soit reellement executable. 

Cela peut sembler desagreable que cette feuille de style n'utilise pas le prefixe xsi ordi- 
nal re ettraditionnel, mais 11 faut bien voir qu'elle est generee, et qu'elle n'est pas desti nee a 
etre lue ou maintenue par un etre humain. 

L'autre probleme a resoudre est la generation d'un document auxiliaire, dans un fichier a 
part. Pour cela nous utilisons ['instruction xsi : document, qui ne fait encore partie 
d'aucun standard, mais qui figure dans les Working Drafts 1.1 et 2.0. Cette instruction 
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utilise les memes attributs que xsi : output, a part un attribut supplementaire, href, dont la 
valeur donne I'URI du fichier de destination du resultatde I'instanciation deson modelede 
transformation. Ici, nousl'utilisonspourgenererlecontenu du fichiertemp.bat : 

<xsl idocument href="temp.bat" methocl="text"> 

<xsl :text>java -classpath "C:Files.jar;" </xsl:text> 

<xsl :text>coin.icl .saxon. Stylesheet -o out. memo </xsl:text> 

<xsl : val ue-of select= "/Express ions /©source Fi 1 e"/> 

<xsl :text> XPathExpressions.xsK/xsl :text> 
</xsl :document> 

Nous avons fait le tour des problemes a resoudre pour obtenir une feuille de style qui en 
genere une autre ; le resultat final est montre ci-dessous : 

XPathlnterpretor.xsl 

<?xml version="1.0" encoding="LITF-16"?> 
<xsl rstylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforni" 

xinlns:aaa= "http://machin" 

version = "!.!"> <!-- compatibilite Saxon 6.5 --> 



<xsl:output method^'xml ' encoding='IS0-8859-l' indent^'yes' /> 
<xsl mamespace-alias stylesheet-prefix="aaa" resul t-pref ix="xsl "/> 



<xsl :templ ate match='/'> 
<aaa:stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.0"> 

<aaa:output method^'text' encoding="IS0-8859-r7> 



<xsl idocument href="temp.bat" method="text"> 

<xsl :text>java -classpath "C:Files.jar;" </xsl:text> 
<xsl :text>coin.icl .saxon. Stylesheet -o out. memo </xsl:text> 
<xsl :value-of select="/Expressions/@sourceFile"/> 
<xsl :text> XPathExpressions.xsK/xsl :text> 

</xsl :document> 

<xsl :apply-templates/> 
</aaa:stylesheet> 
</xsl itempl ate> 



<xsl :template match='Expressions'> 
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<!-- 1 --> 
<aaa :templ ate> 

<xsl lattribute name="iiiatch">/</xsl :attribute> 
<xsl :for-each sel ect="XPath"> 
=== id = <xsl :value-of select="@id"/> === 
<aaa : apply- tempi ates> 

<xsl :attribute naine="mode">M<xsl :value-of select="@id"/> 
</xsl :attribute> 
</aaa : apply- tempi ates> 
</xsl :for-each> 
</aaa:templ ate> 
<!-- /I --> 

<!-- 2 --> 

<xsl :for-each sel ect="XPath"> 
<aaa itempl ate> 

<xsl lattribute name="match">text( X/xsl :attribute> 
<xsl lattribute name="mode">M<xsl :value-of select="@id"/> 
</xsl :attribute> 
</aaa :templ ate> 
</xsl :for-each> 
<!-- 12 --> 

<!-- 3 --> 

<xsl :for-each sel ect="XPath"> 

<aaa itempl ate> 

<xsl lattribute name="match"> 

<xsl :value-of sel ect="@contextNode"/> 
</xsl :attribute> 

<xsl lattribute name="mode">M<xsl :value-of select="@id"/> 
</xsl :attribute> 

{ 

-- contextNode="<xsl :val ue-of sel ect="@contextNode"/>" 
-- expression="<xsl :val ue-of select="@expression"/>" 
<aaa:for-each> 

<xsl :attribute name="sel ecf'Xxsl :value-of sel ect="@expression"/> 

</xsl :attribute> 

<aaa:value-of> 

<xsl lattribute name="select">.</xsl :attribute> 
</aaa:value-of> 

</aaa:for-each> 

} 

</aaa:template> 
</xsl :for-each> 
<!-- /3 --> 

</xsl itempl ate> 

</xsl :stylesheet> 
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Motivation 

Avec I'avenement des applications Internet, il afallu mettreau point dessystemescapa- 
bles degenerer des pages HTM L dynamiques. En effet, I'envoi de simples pages HTM L 
statiques est en general tres insuffisant pour une application qui doit extraire ou calculer 
des informations (typiquement en provenance d'une base de donnees) et les presenter a 
rinternaute. La generation de pages dynamiques, en general, vient en complement des 
pages statiques, carl I estbien rare que tout sol tdynami que dans une page: il yatres sou- 
vent un fond statique, sur lequel on plaque les donnees dynamiques. Ce pattern va mon- 
trer comment faire pour construire une page dynamique a partir d'un fond statique et de 
donnees auxi 11 aires. 



Remarque 

Nous avons deja vu un exemple de generation de pages dynamiques, au tout debut, pourdonnerun avant-gout 
du langageXSLT (voirUn avant-goijtdXSLT, page 9). Mais cette page dynamique etaitrealisee avec une feuille 
de style simplifiee (Simplified Stylesheet), dontles possibilites en matierede transformation etde traitementsont 
tres limitees. Ici nous allons voir I'equivalent d'une fa?on plus evoluee, permettant par exemple d'envisagerde la 
traduction « a la volee » (voir Pattern n '18 - Localisation d line application, page 533), 

La premiere chose a faire est dedefinirle fond statique, car c'estlui qui va piloter I'appel 
des donnees dynamiques aux bons endroits. Leplussimpleestici de prendre un exemple. 
N ous allons supposer que nous voulons afficher une page d'annonce du prochain concert ; 
lefond statique aura I 'allure suivante : 

fond.xinl 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<title>Les Concerts Anacreon</titl e> 
</head> 
<body> 

<H1 al ign="center"> Concert le <dateConcert/> </Hl> 

<H4 al ign="center''> <1 ieuConcert/> </H4> 

<H2 al ign="center''> Ensemble <ensemble/> </H2> 

<listeMusiciens> 
<P> 

<niusicien/>, <instruinent/> 

</p> 

</l isteMusiciens> 



<H3> 

Oeuvres de <1 i steCompositeurs/> 
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</H3> 

</body> 
</html> 

Le fond est done constitue majoritairement de balises HTM L ; cependant, la ou on a 
besoin de valeurs dynamiques, un element non HTM L est la pour reclamer une valeur 

(par exemple, <dateConcert/>). 

U ne des difficultes pouvant se apparaitre dans un tel contexte, c'est la presence de don- 
nees a repeter un certain nombre de fois, nombre qui est naturellement inconnu a cet 
endroit. Nous avons illustre ceci avec la listedes musiciensafairefigurer : on nesait pas 
combien 11 y en a, maiscequ'on salt, c'est que chaque musicien doitetrementionne avec 
son nom et son instrument. On doit done ici se contenter de definir comment doit appa- 
raitre une des lignes d'affichage de musicien : 

^ <p> unNomDeMusicien, leNomDeSonlnstrument </p> 

C'est ce qui estexprime par le bloc : 

<listeMusiciens> 
<P> 

<musicien/>, <instrument/> 

</p> 

</listeMusiciens> 

Avantde voir comment mettre au point une transformation XSLT adequate, remarquons 
tout de suite que cette fagon de proceder est conforme a I'idee generale de la separation 
des competences que I'on essaye toujours d'obtenir dans la mise au point d'une applica- 
tion Internet; ici un graphiste sans competence particuliere en programmation XSLT 
pourra parfaitementecrire lefond statique, avec les appels de donnees dynamiques. 

Cefond statique va done appeler des donnees dynamiques ; dans la pratique, avec un serveur 
d'application commeWeb Logic deBEA ou d'autresdu meme genre, 11 estassez peu proba- 
ble que ces donnees dynamiques soient placees dynamiquement dans un fichier. En fait, les 
donnees sont en memoire sous forme d'objets, et le processus va consister a construire un 
arbre DOM (Document Object M odel) avec ces objets. 

Note 

Un arbre DOM n'estrien d'autre qu'une implementation particuliere de I'arbre XML d'un documentXML. 

Une fois I'arbre DOM construit, 11 est strictement equivalent a un document XM L, du 
point devuedu processeur XSLT. Le serveur d'application (la servlet en cours) va done 
activer le thread du processeur XSLT resident (charge avec les autres servlets par le ser- 
veur d'application) en lui transmettantl'URI du fichier statique a traiterainsi que I'arbre 
DOM des donnees dynamiques, ce qui est faisable avec I'API TrAX (Transformation 
API forXM L), reprise dans J AX P deSUN (Java A PI forXML). On seretrouvealors, du 
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point de vue X SLT, avec deux sources X M L , une source principale, et une source auxi- 
liaire accessible par un appel a la fonction documentc ). 

Mais pour simplifier, nous supposerons ici que nous avons deux sources XML sous 
forme de fichiers, le seul probleme etant de realiser la transformation qui va donner la 
pagedynamique. 

Le fichier auxiliaire des donnees est le suivant : 



Annonce.xtnl 

<?xml version="1.0" encoding="UTF-16"?> 



<Annonce> 



<Date> 

<Jour>Jeudi</Jour> 

<Quantieine>17</Quantieme> 

<Mois>janvier</Mois> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Enseinble>A deux violes esgales</Ensemble> 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Noin> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 



<Interprete> 

<Noiii> Benjamin Perrot </Nom> 
<Instrument>Theorbe</Instrument> 

</Interprete> 



<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Cl avecin</Instruinent> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</CompositeLirs> 



</Annonce> 



Pattern n° 16 - Generation de pages HTML dynamiques H 

cTiapitrF9^H 

Realisation 

Lefichier principal est le ficliier statique, car il est fait pour piloter I'appel desdonnees 
dynamiques. Leficliier resultat(la pagedynamique) estia pagestatique, dans laquelleles 
appels de valeurs sont remplaces par leur valeur : nous sommes done dans un cas typique 
d'utilisation du pattern « copie non conforme ». 

L'idee de base, ici, est que par defaut, les elements doivent etre recopies sans modifica- 
tion ; nous al Ions done adopter la regie avec priori te basse vue a la section Copie conforme 
gene'rique, page 444 : 

<xsl : tempi ate niatch="chi Id: :node( ) | attribute: :*" priori ty="- 10" > 
<xsl :copy> 

<xsl :apply-teinplates select="attribute: :*" /> 
<xsl :apply-teinplates select="child: :node( )" /> 
</xsl :copy> 
</xsl :templ ate> 

Cette regie est a contredire uniquement pour les elements qui constituent un appel de 
valeur dynamique. Dans notre cas, cela concerne les elements <dateConcert/>, <iieu- 

Concert/>, <ensemble/>, <1 i steMusi ci ens>, <musicien/>, <i nstrument/>, <listeCotn- 

positeurs/>. II va donc falloir une regie sped fique pour chacun d'eux. 

Les elements <dateConcert/>, <1 i euConcert/>, <ensemble/>, et <1 i steCompositeurs/> 

ne posent pas de probleme parti culier et reposent tous sur le meme model e ; leur traitement 
necessite d'avoir acces a la source XML secondaire : 

<xsl :param naine="annonceFileRef">Annonce.xml</xsl :param> 

<xsl :variable name="Annonce" select="docunient($annonceFileRef )/Annonce"/> 

<xsl :teniplate niatch='dateConcert'> 

<xsl :val ue-of sel ect="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl:text> </xsl:text> 

<xsl :value-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Heure" /> 
</xsl :templ ate> 



<xsl :template match='lieuConcert'> 

<xsl :val ue-of select="$Annonce/Lieu" /> 
</xsl :templ ate> 
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<xsl itempl ate match='ensenible'> 

<xsl :val ue-of select="$Annonce/Ensemble" /> 
</xsl itempl ate> 

<xsl itemplate match='listeCompositeurs'> 

<xsl :val ue-of select="$Annonce/Compositeurs" /> 
</xsl itempl ate> 

L'element <i isteMusiciens> est un peu plus complique a mettre au point. II faut copier 
son modelede transformation, asavoir : 

I <P> 

<musicien/>, <instrument/> 

' </p> 

autant de fois que Ton va trouver l'element <interprete> dans le document 
Annonce.xmi, puisqu'il faudra bien qu'il y ait autant de <p> ... </p> quede musiciens. 
Done la regie va commencer par un <xsi :for-each> pour traiter le node-set des <inter- 
prete> du document auxiliaire : 

<xsl itemplate match='listeMusiciens'> 

<xsl ifor-each select="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 

</xsl ifor-each> 
</xsl itempl ate> 

La variable current-interprete conserve le noeud courant, c'est-a-dire l'<inter- 
prete> courant, car I'experience montre qu'on a frequemment besoin de se reperer 
par rapport au noeud courant dans une instruction <xsi :for-each> ; et meme si cette 
variable n'est pas indispensable, elle permet de mieux s'y retrouver pour construire 
la regie. 

Mais n'oublions pas que la regie doit instancier n fois le modele de transformation 
indique plus haut ; I'unede ces instanciations peut sefaire par un <xsi :copy>, a condi- 
tion que le noeud contexte soit place sur l'element <p>. Or la ou il y a les points de sus- 
pension, dans la regie ci-dessus, le noeud contexte n'est pas place sur <p>, parce que 
I'instruction <xsi :for-each> deplace le noeud contexte sur le noeud en cours. Le noeud 
contexte, a cet endroit, est done place dans I'arbreX M L du document auxiliaire, sur le 
noeud <interprete> courant, celui qui precisement, est reference par la variable 

current-interprete. 

Pour remettre le noeud contexte sur l'element <p> afin de permettre la copie, il n'y a 
qu'une seule solution : utiliser a nouveau un <xsi :for-each>, puisque c'est la seule ins- 
truction capable de deplacer le noeud contexte. Pour cela, il faut sauvegarder le noeud 
courant a I 'entree de la regie (1), puis selectionner son enfant direct <p> (2) : 

<xsl itemplate match='listeMusiciens'> 

<xsl ivariable name="current-listeMusiciens" select="."/> <!-- (1) --> 
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<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 
<xsl :for-each select="$current-listeMusiciens/p"> <!-- (2) --> 
<xsl :copy> 

</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl rtempl ate> 

Nous avons maintenant une regie presque complete ; I 'instruction <xsi :copy> va copier 
I'element <p>, mais les elements enfants de <p> sont des elements non HTM L, qui doi- 
vent faire I'objet d'une regie specifique, du meme genre que celle de <iieuConcert/>, 
par exemple. II est done necessaire d' avoir un <xsi :appiy-tempiates> la ou setrouvent 
les points de suspension, ci-dessus : 

<xsl itemplate niatch='listeMusiciens'> 

<xsl ivariable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 
<xsl :for-each sel ect="$current-l isteMusiciens/p"> 
<xsl :copy> 

<xsl :apply-teinplates/> 
</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl itempl ate> 

<xsl : tempi ate match='musicien'> 

<xsl :value-of select^"???" /> 
</xsl itempl ate> 

L'idee est bonne, car apres avoir copie I'element <p>, I'instruction <xsi :appiy-tempiates> 
va effectivement selectionner ses enfants directs (c'est-a-dire I'element <rtmsicien/>, le 
texte ' . "' (virgule, espace, guillement) et I'element <instrument/>, (plus eventuelle- 
ment des noeuds texte ne contenant que des espaces blancs sans interet), et done la regie 

<xsl : tempi ate match='musi cien '> va etre Selectionnee. 

Le probleme, c'est que dans cette regie, on est cense instancier le nom d'un musicien ; 
malheureusement, le musicien en question, on I'a perdu. II etait dans la variable 
current-interprete qui est desormais inaccessible. Inaccessible? Pastoutafait: I'ins- 
truction <xsi :appiy-tempiates> autorise la transmission d'arguments. C'est assez rare 
d'avoir a utiliser cette possibilite, mais la, c'est le moment oil jamais : 

<xsl itemplate match='listeMusiciens'> 

<xsl ivariable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 
<xsl ifor-each sel ect="$current-l isteMusiciens/p"> 
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<xsl :Copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl itempl ate> 

<xsl :template match='niusicien'> 

<xsl:parani name="interprete"/> 

<xsl :val ue-of select="$interprete/Noin" /> 
</xsl itempl ate> 

Du coup, la regie specifique pour l'<instrument/> va pouvoir etre faite sur le meme 
modele, puisque die sera selectionne elleaussi par le meme <xsi :appiy-tempiates> : 

<xsl itemplate match='instrument'> 

|<xsl:param nanie="interprete"/> 
<xsl :val ue-of select="$interprete/Instrunient" /> 
</xsl itempl ate> 

M ais que va-t-il advenir du noeud text contenant " , " ? Le processeur va chercher 
une regie a lui appliquer, ne va pas en trouver, et va done appliquer la regie par defaut 
(voir Regies par defaut pour un n^ud de type text ou attribute, page 120) pour les 
noeuds text. Or cette regie par defaut ne prend pas de parametre en donnee, alors que 
rinstruction <xsi iappiy-tempiates> responsable de I'activation de cette regie en a 
transmis un. Ceci n'est pas une erreur (voir la section Semantique, page 234), et heu- 
reusement, parce que sinon, cela compliquerait diablement les choses s'il fallait 
eviter cette situation. 

On peut done maintenant rassembler les morceaux pour obtenir le programme complet : 

AnnonceConcert.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl I stylesheet xinlnsixsl="httpi //www. w3.org/1999/XSL/Transform" 
version="1.0"> 

<xslioutput method^'html ' encoding='IS0-8859-r /> 

<xsl iparam nanie="annonceFi 1 eRef ">Annonce.xml</xsl iparam> 

<xsl ivariable name="Annonce" select="document($annonceFileRef )/Annonce"/> 

<xsl itemplate match="childi inode( ) |attributei i*" priority="-10"> 
<xsl icopy> 

<xsl lapply-templates select="attributei i*" /> 
<xsl lapply-templates select="childi inode()"/> 
</xsl icopy> 
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<xsl itemplate niatch='dateConcert'> 

<xsl :val ue-of sel ect="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 

<xsl :value-of select="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annonce/Date/Heure" /> 
</xsl itempl ate> 

<xsl itemplate niatch='lieuConcert'> 

<xsl :value-of sel ect="$Annonce/Lieu" /> 
</xsl itempl ate> 

<xsl itempl ate match='ensemble'> 

<xsl ival ue-of select="$Annonce/Ensemble" /> 
</xsl itempl ate> 

<xsl itemplate match='listeMusiciens'> 

<xsl ivariable name="current-listeMusiciens" select="."/> 

<xsl ifor-each sel ect="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 

<xsl ifor-each sel ect="$current-l i steMusiciens/p"> 
<xsl icopy> 

<xsl iapply-templates> 

<xsl iwith-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl iapply-templates> 
</xsl icopy> 
</xsl ifor-each> 
</xsl I for-each> 
</xsl itempl ate> 

<xsl itemplate match='musicien'> 
<xsliparam name="interprete"/> 
<xsl ival ue-of select="$interprete/Nom" /> 
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</xsl :templ ate> 

<xsl itemplate match='instrument'> 

<xsl:param nanie="interprete"/> 

<xsl :value-of select="$interprete/Instrunient" /> 
</xsl itempl ate> 

<xsl itemplate match='listeCoinpositeurs'> 

<xsl :value-of select="$Annonce/Compositeurs" /> 
</xsl itempl ate> 

</xsl :stylesheet> 

Etvoici le resultatobtenu : 

Annonce.html 

<html> 

<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<title>Les Concerts Anacréon</title> 



<body> 

<H1 align="center"> Concert le Jeudi 17 Janvier 2002 20H30 </Hl> 

<H4 al ign="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 




</head> 



Jonathan Dunford 



Basse de viole 



</p> 
<P> 



Sylvia Abramowicz , Basse de viole 



</p> 
<p> 



Benjamin Perrot , Théorbe 



</p> 
<p> 



Freddy Eichelberger , Clavecin 



</p> 
<H3> 



Oeuvres de 



M. Marais, D. Castello, F. Rognoni 



</H3> 
</body> 
</html> 



Dans le fichier ci-dessus, les lignes blanches ont ete enlevees pour gagner de la place ; le 
rendu HTML est montre a la figure 9-4. 
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Figure 9-4 

Aspect de la page 
dynamique obtenue. 



m -|n| 




J Fichlei Edition Affichage Favoiis Oulils ? |j Liens ^^^^ 


Concert le Jeudi 17 Janvier 2002 20H30 


J 


Ch^telle des Ursules 




Ensemble A deux violes esgales 




■J UXXvl^iuIi I-' ^4111 Ul , UQ&^C VlUiC 




Sylvia Abramowicz , Basse de viole 




B enj ainin PeiTot,Theorbe 




Freddy Eichelberger, Clavecin 




Oeuvres de M. Marais, D. Castello, F. Rognoid 


J 


Teimine ^ Poste de travail 





Conclusion 

Le pattern que nous venons de voir permet de generer des pages HTM L dynamiques, 
mais 11 ne faut pas croire que ce soit la seule application possible. Par exemple, sur le 
meme principe, on peut construire un generateur de classes Java, qui utilise des fonds 
statiquesdece style: 

Measure.tmpl 

<?xml version="1.0"?> 

<tenipl ate> 

// 

// 

// 

// stored Measure <MeasureName/> 
// 

// 

protected <MeasureType/> <MeasureName/>; 

public final <MeasureType/> get<MeasureNamewithCapital />( ) { 
return <MeasureNaine/>: 

} 



public final void set<MeasureNamewithCapital />( 

<MeasureType/> <aMeasureName/> ){ 
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super. setAttribute("<MeasureName/>" , <aMeasureNanie/>.toString( ) ) ; 
<MeasureName/> = <aMeasLireNaine/>: 

Assertion. ensureC get<MeasureNamewithCapital/>( ) <aMeasureName/> ); 

} 

</templ ate> 

L e generateur construit une classej ava en assemblant un certain nombre de petites pieces 
de puzzle comme celle montree ci-dessus (I 'element <tempiate>), oil les elements XM L 
sontdes appels devaleurs, exactement comme dans lefichier fond.xmi utilise en exem- 
ple pour la generation de pages HTM L dynamiques. Les « valeurs » sont obtenues dans 
des fichiers XML source auxiliaires qui derivent des differentes phases anterieures de 
modelisation, comme on peut en avoir un aperfu dans I'extrait ci-dessous : 

Entity .xml 

<Entity name="Contract" persi stance="simpl e" IHMconnected="true"> 

<MeasureRef id="beginningDate" /> 

<MeasureRef id="contractNbr" i sPartOf Key="yes" /> 

<MeasureRef id="type" /> 
</Entity> 

<Entity nanie="Country" persistance="simple" > 

<MeasureRef id="countryCode" i sPartOf Key="yes" /> 

<MeasureRef id="zoneEuro" /> 
</Entity> 

<Measure name="contractNbr" type="String" access="stored" /> 
<Measure name="type" type="String" access="stored" /> 
<Measure name="coefficient" type="String" access="stored" /> 
<Measure name="countryCode" type="String" access="stored" /> 
<Measure name="zoneEuro" type="Bool ean" access="stored" /> 
<Measure name="beginningDate" type="BusinessDate" access="stored" /> 



Pattern n° 17 - Generation de pages HTML dynamiques 
pour un portail 

Le pattern que nous allons voir ici reprend le precedent, en le modifiant legerement pour 
montrer comment generer une page dynamique pour un portaiL Ce qui va changer, c'est 
lefait qu'il ne va plusy avoir un seul fichier XM L auxiliairede description des donnees, 
maisplusieurs. En effet, dansun portail, 11 y a multituded'informations rassembleesdans 
une seule page, et ces informations ne proviennent pas toutes du meme fichier, evidem- 
ment. II y a done de nombreuses sources X M L a exploiter et a synthetiser dans la genera- 
tion dynamique de la page. Pour les besoins de I'exemple, nous aurons deux sources 
XML, et ce n'est plus le programme XSLT qui connait d'avance le nom des fichiers 
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XM L a consulter, mais c'est le fond statique qui I'indique, avec des balises modifiees 
commececi : 

fond.xnil 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<title>Les Concerts Anacreon</title> 
</head> 
<body> 

<H1 align="center"> Concert le <dateConcert href="Annonce.xml "/> </Hl> 

<H4 align="center"> <lieuConcert href="Annonce.xinl "/> </H4> 

<H2 align="center"> Ensemble <ensemble href="Annonce.xml "/> </H2> 

<1 i steMusi ciens href="Annonce.xml "> 
<P> 

<inusicien/>, <instrument/> 

</p> 

</listeMusiciens> 
<H3> 

Oeuvres de <listeCoirpositeurs href="Annonce.xnil "/> 
</H3> 



<P> 

Reservations : <reservations href="Reservations .xml "/> 

</p> 

</body> 
</html> 

Ce fond contient desormais des balises qui font reference aux ficiiiers XM L a exploiter 
pour aller chercher les valeurs a placer dynamiquement. Le fichier Annonce.xmi reste 
identiquea cequ'il etait a la section precedente (voir Pattern n°16-G<?n(?ration de pages 
HTML dynamiques, page 518). Le fichier Reservations. xmi contient les informations 
suivantes : 

Reservations .xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Reservations> 

<Reservation> 

<Lieu>Chapelle des Llrsules</Lieu> 

<Tel>02 41 11 12 13 14</Tel> 
</Reservation> 
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<Reservation> 

<Lieu>Anacreon</Lieu> 
<Tel>02 41 99 97 98 99</Tel> 

</Reservation> 



<Reservation> 

<Lieu>FNAK</Lieu> 

<Tel>02 41 00 97 98 99</Tel> 
</Reservation> 



</Reservations> 



La consequence est que le programme X SLT ne doit plus creer une fois pour toutes une 
variable contenant la source auxiliaire, mais doit pouvoir changer de source eventuel- 
lementachaqueregle : 

AnnonceConcert.xsl 



<?xml version="1.0" encoding="LITF-16"?> 

<xsl : stylesheet xmlns:xsl=" http://www.w3.org/1999/XSL/Transforin" 
version="1.0"> 



<xsl:output method^'html ' encoding='IS0-8859-r /> 

<xsl : tempi ate match=" child: :node( ) | attribute: :*" priori ty="-10"> 
<xsl :copy> 

<xsl : apply-templ ates select="attribute: :*" /> 
<xsl :apply-teniplates select="child: :node()"/> 
</xsl :copy> 
</xsl :templ ate> 



<xsl :template match='dateConcert'> 



<xsl :variable naine="Annonce" sel ect="document(@href )/Annonce"/> 



<xsl :value-of select="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Quantieine" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Heure" /> 



</xsl :templ ate> 
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<xsl itemplate niatch='lieuConcert'> 

<xsl ivariable name="Annonce" sel ect="document(@href )/Annonce"/> 

<xsl :val ue-of sel ect="$Annonce/Lieu" /> 
</xsl itempl ate> 

<xsl : tempi ate match='ensemble'> 

<xsl ivariable name="Annonce" sel ect="document(@href )/Annonce"/> 

<xsl :value-of sel ect="$Annonce/Ensembl e" /> 
</xsl :templ ate> 

<xsl itemplate niatch='listeMusiciens'> 

<xsl ivariable name="Annonce" select="clocument(@href )/Annonce"/> 
<xsl ivariable name="current-listeMusiciens" select="."/> 

<xsl ifor-each sel ect="$Annonce/Interprete"> 

<xsl ivariable name="current-Interprete" select="."/> 

<xsl ifor-each select="$current-listeMusiciens/p"> 
<xsl icopy> 

<xsl iapply-templates> 

<xsl iwith-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl iapply-templates> 
</xsl icopy> 
</xsl ifor-each> 
</xsl ifor-each> 
</xsl itempl ate> 

<xsl itemplate match='musicien'> 

<xsliparain naine="interprete"/> 

<xsl ival ue-of select="$interprete/Nom" /> 
</xsl itempl ate> 

<xsl itemplate match='instrument'> 

<xsliparam name="interprete"/> 

<xsl ival ue-of select="$interprete/Instrument" /> 
</xsl itempl ate> 

<xsl itemplate match='listeCompositeurs'> 

<xsl ivariable name="Annonce" sel ect="document(@href )/Annonce"/> 
<xsl ival ue-of select="$Annonce/Compositeurs" /> 

</xsl itempl ate> 

<xsl itemplate match='reservations'> 
<xsl ivariable name="reservations" 

sel ect= " document (@h ref )/ Reservations "/> 
<xsl ifor-each select="$reservations/Reservation"> 
<br/> 

<xsl ifor-each select="*"> 

<xsl ivalue-of select^"." /> 

<xsliif test="position( ) last()"> 
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<xsl:text>, </xsl:text> 
</xsl :if> 
</xsl :for-each> 
</xsl :for-each> 
</xsl :templ ate> 

</xsl :stylesheet> 

Commeon peutlevoir, leschangementsapportessonttresmodestes : il suffitdesupprimer 
la declaration de variable globale, et de placer une declaration equivalente dans chaque 
regie dontle motif Concorde avec une balise susceptible d'avoir un attribut href. 

La regie pour traiter les reservations ne prejuge pas du contenu du fichier Reserva- 
tions. xmi : la seule chose qui soit demandee, c'est qu'il y ait un ou plusieurs elements 
<Reservation>, et cela suffit pour que le contenu deces elements soit afficlie. 

Voici leresultatobtenu (sans les lignes blanches inutiles) : 

AnnonceConcert.htinl 

<html> 

<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title>Les Concerts Anacr&eacLite;on</title> 
</head> 
<body> 

<H1 align="center"> Concert le Jeudi 17 Janvier 2002 20H30 </Hl> 

<H4 al ign="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 

Jonathan Dunford , Basse de viole 

</p> 
<P> 

Sylvia Abramowicz , Basse de viole 

</p> 
<P> 

Benjamin Perrot , Th&eacute:orbe 

</p> 
<p> 

Freddy Eichelberger , Clavecin 

</p> 
<H3> 

Oeuvres de 
M. Marais, D. Castello, F. Rognoni 

</H3> 
<p> 

R&eacute:servations : <br>Chapelle des Ursules, 02 41 11 12 13 
14<br>Anacréon, 02 41 99 97 98 99<br>FNAK, 02 41 00 97 98 99 

</p> 
</body> 
</html> 
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Pattern n° 18- Localisation d'une application 

Motivation 

Un produitetantde pi us en plussouventcongu pour etre vendu danslemondeentier, il faut 
eventuellement, suivant sa nature, le « localiser » pour pouvoir le vendre. La localisation 
consiste a adapter le produit aux us et coutumes du pays vise, I'aspect le plus evident de 
cette adaptation portant sur la traduction des textes a presenter a I'utilisateur final. 

Un cas parti culier extremement frequent de localisation est celle qui consiste a adapter 
une application Internet a la langue(voirea la legislation ...) du pays de I'utilisateur iden- 
tifie. LorsqueXSLT est utilise pour generer des pages HTM L dynamiques (comme dans 
le pattern que I'on vient de voir), 11 est souhaitable de realiser la localisation simultane- 
ment. N ous al I ons done reprendre exactement le meme exemple que precedemment, et le 
meme pattern degeneration dynamiquede pages HTM L, en lui associantun dictionnaire 
de traduction en fonction d'une langue cible. 

Realisation 

Le principe est le meme que pour I e pattern de generation de pages HTML dynamiques ; 
nous allons done reprendre le fichier fond.xmi tel qu'il etait a la section Pattern n° 16 - 
Generation de pages HTM L dynamiques, page 518, mais en le modifiant pour remplacer 
touttexte litteral par un appel de valeur permettant la traduction : 

fond.xmi 

<?xnil version="1.0" encocling="UTF-16"?> 
<htnil> 
<head> 

<title>Les Concerts Anacreon</title> 
</head> 
<body> 

<H1 align="center"> <concertLe/> <dateConcert/> </Hl> 
<H4 align="center"> <lieuConcert/> </H4> 
<H2 align="center"> <ensenible/> </H2> 

<listeMusiciens> 
<P> 

<musicien/>, <instrument/> 

</p> 

</listeMusiciens> 
<H3> 

<oeuvresDe/> 
<1 i steCompositeurs/> 
</H3> 



</body> 
</html> 
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La traduction proprementdite a dejaetevue (voir la section Exemple, page 223) ; il suffit 
done de reprendre cette teclinique de traduction et de I'associer au pattern « Generation 
de pages HTM L dynamiques ». Voici le ficliier source auxiliaire : 

Annonce.xtnl 

<?xml version="1.0" encocling="UTF-16"?> 

<Annonce> 

<Date> 

<Oour icl="jeu"/> 

<Quantieme>17</Quantieme> 

<Mois id="jnv"/> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Enseinble>A deux violes esgales</Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument id="bvr7> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Noin> 

<Instrument id="bvr7> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Noiii> Freddy Eichelberger </Nom> 

<Instrument id="clv"/> 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



</Annonce> 
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L a traduction est basee sur un dictionnaire, qui doit comporter un equivalent dans cliaque 
langue des appels de valeurs presents dans lefond statique : 

Dictionnaire. xml 



<?xnil version="1.0" encoding="UTF-16"?> 

<Dictionnaire> 

<mot icl="bvl"> 

<traduction 1 ang="f r">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 

</mot> 

<mot id="vdg"> 

<traduction lang="fr">Viole de ganibe</traduction> 
<traduction lang="en">Viola da ganiba</traduction> 

</mot> 



<mot id="lth"> 
<traduction 
<traduction 

</mot> 

<mot id="clv"> 
<traduction 
<traduction 

</niot> 

<mot id="flt"> 
<traduction 
<traduction 

</mot> 

<mot id="thb"> 
<traduction 
<traduction 

</mot> 

<mot id="lun"> 
<traduction 
<traduction 

</mot> 



I ang="f r">Luth</traduction> 
I ang="en">Lute</traduction> 



I ang="f r">Cl avecin</traduction> 
I ang="en">Harpsichord</traduction> 



I ang="f r">Fl ute a bec</traduction> 
I ang="en">Recorder</traduction> 



I ang="f r">Theorbe</traduction> 
I ang="en">Theorbo</traduction> 



I ang="f r">l undi</traduction> 
I ang="en">monday</traduction> 



<!-- etc. (les autres jours de la semaine) --> 

<mot id="jeu"> 

<traduction 1 ang="f r">jeudi</traduction> 

<traduction 1 ang="en">thursday</traduction> 

</mot> 
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<mot id="jnv"> 

<traduction 1 ang="f r">janvier</traduction> 

<traduction 1 ang="en">january</traduction> 
</niot> 

<!-- etc. (les autres mois de I'annee) --> 

<mot id="dcb"> 

<traduction 1 ang="f r">decembre</traduction> 

<traduction 1 ang="en">december</traduction> 
</mot> 

<inot id="concertLe"> 

<traduction 1 ang="f r">Concert le</traduction> 

<traduction 1 ang="en">Concert on</traduction> 
</mot> 

<inot id="oeuvresDe"> 

<traduction 1 ang="f r">Oeuvres de</traduction> 

<traduction 1 ang="en">Works by</traduction> 
</mot> 

<inot id="MarqueQuantieme"> 

<traduction 1 ang="f r"></traduction> 

<traduction 1 ang="en">th</traduction> 
</mot> 

</Dictionnaire> 

Le programme XSLT est une adaptation du programme precedent, danslequel on integre 
des appels a un modele nomme de traduction : 

Annonce.xsl 

, <?xml version="1.0" encoding="LITF-16"?> 

<xsl : stylesheet xnilns:xsl=" http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:Dutput method^'html ' encoding='IS0-8859-r /> 

<xsl iparam name="langueCible">fr</xsl :param> 

<xsl iparam nanie="dicoFileRef">dictionnaire.xnil</xsl :pararti> 

<xsl iparam name="annonceFi 1 eRef ">Annonce.xml</xsl iparam> 

<xsl ivariable naine="Dictionnai re" 

sel ect=" document ( $di coFi 1 eRef) /Diet ionna ire" /> 
<xsl ivariable name="Annonce" 

sel ect=" document ($annonceFi 1 eRef )/Annonce"/> 
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<xsl itemplate name="instancier-traduction"> 
<xsl:parain naine="inotId"/> 



<xsl ivariable 

name="motTrouve" 

sel ect="$Dictionnai re/mot [@id=$mot Id]" /> 



<xsl ivariable 

nanie="saTraduction" 

sel ect="$inotTrouve/traduction[@l ang=$l angueCibl e] " /> 



<xsl :val ue-of sel ect="$saTraduction" /> 
</xsl :templ ate> 



<xsl : tempi ate match="chi Id: :node( ) | attribute: :*" priori ty="- 10" > 
<xsl :copy> 

<xsl :apply-teinplates select="attribLite: :*" /> 
<xsl :apply-teinplates select="child: :node( )"/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match='concertLe'> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" select^" 'concertLe' " /> 

</xsl :call-template> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 



<xsl :template name='instancier-Date'> 



<xsl:param name="Jour"/> 
<xsl:param name="Quantieme"/> 
<xsl:param name="Mois"/> 
<xsl:param name="Annee"/> 



<xsl :choose> 

<xsl :when test="$langueCible = 'fr'"> 

<xsl :val ue-of sel ect="$Jour"/> 

<xsl:text> </xsl:text> 

<xsl :value-of select="$Quantieme"/> 

<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Moi s"/> 

<xsl:text> </xsl:text> 

<xsl :val ue-of sel ect="$Annee"/> 
</xsl :when> 



<xsl :when test="$langueCib1e = 'en'"> 
<xsl :val ue-of sel ect="$Jour"/> 
<xsl:text>, the </xsl:text> 
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<xsl :value-of select="$Quantieme"/> 
<xsl:text>th of </xsl:text> 
<xsl :value-of select="$Mois"/> 
<xsl:text>, </xsl:text> 
<xsl :value-of select="$Annee"/> 
</xsl :when> 
</xsl :choose> 



</xsl :template> 



<xsl itemplate match='dateConcert'> 

<xsl :call -template name="instancier-Date"> 

<xsl :with-param name="Jour"> 

<xsl :cal 1 - tempi ate name="instancier-traduction"> 
<xsl iwith-param name="motId" 

sel ect="$Annonce/Date/Jour/@id" /> 

</xsl :call-template> 
</xsl :with-param> 

<xsl :with-param name="Quantieme"> 

<xsl :value-of select="$Annonce/Date/Quantieme" /> 
</xsl :with-param> 

<xsl :with-param name="Mois"> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 
<xsl :with-param name="motId" 

sel ect="$Annonce/Date/Mois/@id" /> 

</xsl :call-template> 
</xsl :with-param> 

<xsl :with-param name="Annee"> 

<xsl :value-of select="$Annonce/Date/Annee" /> 
</xsl :with-param> 

</xsl :call -template> 

<xsl:text> </xsl:text> 

<xsl :value-of select="$Annonce/Date/Heure" /> 



</xsl :template> 

<xsl :template match='lieuConcert'> 

<xsl :value-of select="$Annonce/Lieu" /> 
</xsl :templ ate> 

<xsl itempl ate match='ensemble'> 
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<xsl :val ue-of sel ect="$Annonce/Ensembl e" /> 
</xsl itempl ate> 

<xsl itemplate niatch='listeMusiciens'> 

<xsl ivariable name="current-listeMusiciens" select="."/> 

<xsl :for-each sel ect="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each sel ect="$current-l i steMusiciens/p"> 
<xsl :copy> 

<xsl :apply-teinplates> 

<xsl :with-param name="interprete" 

sel ect="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl : copy> 
</xsl :for-each> 
</xsl :for-each> 
</xsl itempl ate> 

<xsl itempl ate niatch='inusicien'> 

<xsl:param name="interprete"/> 

<xsl :val ue-of select="$interprete" /> 
</xsl itempl ate> 

<xsl itemplate niatch='instrument'> 
<xsl:param name="interprete"/> 
<xsl:text> </xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl iwith-param name="niotId" select="$interprete/Instrument/@id" /> 
</xsl :call-template> 
</xsl rtempl ate> 



<xsl itempl ate match='oeuvresDe'> 

<xsl real 1 -tempi ate name="instancier-traduction"> 

<xsl iwith-param name="motId" select^" 'oeuvresDe' " /> 

</xsl :call-template> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl :template match='listeCompositeurs'> 

<xsl :value-of select="$Annonce/Compositeurs" /> 
</xsl itempl ate> 



</xsl :stylesheet> 
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Le resultat obtenu avec le parametre ianguecibie=en est montre a la figure 9-5. 

Figure 9-5 

Aspect de la page 
dynamique traduite 
en anglais. 

January, 2002 - 20H30 

Cluqielle des Ursiiles 

A deux violes esgales 

Jonathan Dunford , Bass viol 

Sylvia Abraitiowicz , Bass viol 

B enj amin P eirot , The orb o 

Freddy Eichelberger , Harpsichord 

Works by M. Marais, D. Castello, F. Rognoiii 

J 

1^ Teimine I ' Poste de travail ' 
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Fichier Edifion Affichage Favoris Outils 



Liens ■ 



Concert on thursday, the 17th of 



Pattern n° 19 - Construction dynamique de I'agencement 
d'un tableau HTML 

Nous avons deja vu le probleme de la generation dynamique d'une page HTM L, qui 
consiste a creer dynamiquement un contenu, ensuite plaque sur un fond HTML plus 
ou moins statique (voir Pattern n°16 - Generation de pages HTML dynamiques, 
page 518). 

Le pattern que nous allons voir maintenant va beaucoup plus loin : 11 permet de generer 
dynamiquement non seulement le contenu, mais aussi la disposition de ce contenu dans 
la page. 



Note 

L'idee de ce pattern m'est venue en lisantune intervention dej eniTennison (tres active sur la mailing listXSLT 
de www.mulberrytech.com/xsl/xsl-listf). On pourra la retrouveren faisantune recherche de «The evaluate 
function » surle moteurde recherche de www.biglist.com/lists/xsl-list/archives/eten restreignantia recherche 
au mois de janvier2002. 
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Pour fixer les idees, et voir I'interet de la chose, imaginons une application Internet qui 
envoi eau client (un navigateur) un tableau de synthase quel conque, commecelui montre 
en exemple figure 9-6. 



Figure 9-6 

U n tableau a 
plusieurs colonnes. 



fci^ij.ii.i.iiiJ!iijj.u.iiri 



Fichiei Edition Afficliage Favoiis Outils ? 



■ Precedente • - \^ ^ | ^Rechercher Htj Favoris ^Hislorique 



Pndilit 


ISBN 


Prix 


Titre 


Auteur 


hteiprete 


Livre 


193335 


iS 


Vingt mille lieues 
sous les mers 


Jules Vemes 




Livre 


533791 


4.5 


Uingenievu aimait 
trop les chifftes 


Pierre 
Boileau 

Thomas 
Narcejac 




Disque 
Compact 




21 


Les Folies d'Espagtie 


Marin 
Marais 


JonathanDunford, Basse 
de viole 

Sylvia Abramowic^ Basse 
de viole 

B enj amin P errotj The orb e 
et guitare baroque 
Stephana Fuget, Clavecin 



J 



Supposons maintenant que I'interface donne a utilisateur la possibilite de designer deux 
colonnes a permuter ; le probleme est de regenerer le meme contenu de tableau, avec la 
meme transformation XSLT, mais presente avec les deux colonnes permutees. 

Le probleme etant assez complexe a resoudre, et necessitant d'ailleurs I'utilisation 
d'extensionsau langageXSLT (qui vontrendrenon portable la solution proposee), il sera 
ici plus facile de proceder par etapes, afin de voir exactement ou se situent les problemes. 
N ous commencerons done par une version qui se contente de generer le tableau de fagon 
statique, et qui ne permet done aucune permutation, sauf bien stir en all ant modifier le 
programme. 



Version statique 

Le tableau a generer est par exemple un extrait (limite aux CD et aux livres) d'inventaire 
d'un magasin, dont le stock est represents par lefichier baseProd uits.xml : 

baseProduits.xml 

<?xml version=''1.0" encoding^'UTF-ie" ?> 
<BaseProduits> 

<LesProduits> 
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<Livre ref="vernesl" NoISBN="193335" gamnie="roman" inedia="papier"> 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="6" monnaie="EUR"/> 

<Prix valeur="5" nionnaie="£"/> 
</Livre> 



<Livre ref="boileaunarcejacl" NoISBN="533791" ganime="roman" 

media="papier"> 

<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 

<Prix valeur="4.5" monnaie="ELIR"/> 
<Prix valeur="3" monnaie="£"/> 
</Livre> 



<Enregistrement ref="niarai si" Ref EcliteLir="LC000280" 

gamme="vi ol edegambe" medi a="CD"> 

<refOeuvres> 

<Ref valeur="niarais.folies"/> 
<Ref val eur="niarai s .pieces 1685" /> 
</refOeuvres> 
<Interpretes> 

<Interprete nom="Jonathan Dunford"> 

<Role xml : 1 ang="f r"> Basse de viole </Role> 
<Role xml : 1 ang="en"> Bass Viol </Role> 
</Interprete> 

<Interprete nom="Sylvia Abramowicz"> 

<Role xml : 1 ang="f r"> Basse de viole </Role> 
<Rale xml : 1 ang="en"> Bass Viol </Role> 

</Interprete> 

<Interprete noiii=" Benjamin Perrot"> 

<Role xml : 1 ang="f r"> Theorbe et guitare baroque </Role> 
<Role xml : 1 ang="en"> Theorbo and baroque guitar </Role> 

</Interprete> 

<Interprete nom="Stephane Fuget"> 

<Role xml : 1 ang="f r"> Clavecin </Role> 
<Role xml : 1 ang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 
<Titre xml : 1 ang="f r"> 

Les Folies d'Espagne et pieces inedites 
</Titre> 

<Titre xml : 1 ang="en"> Folies d'Espagne and unedited music </Titre> 
<Prix valeur="2r' monnaie="EUR"/> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 
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<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamine="lecteurCD" 

iiiarque="HarKar"> 

<refCaracteristiques> 

<Ref val eur="caracHarKarr7> 
</refCaracteri stiques> 
<Prix valeur="686" monnaie="EUR"/> 
<Prix valeur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<LesOeuvres> 

<Oeuvre ref="200001 slm"> 

<Titre> Vingt mille lieues sous les mers </Titre> 
<refAuteurs> 

<Ref val eur="JVernes"/> 
</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="inarais.folies"> 

<Titre> Les Folies d'Espagne </Titre> 

<refAuteurs> 

<Ref val eur="MMarai s"/> 

</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="inarai s .piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 

<refAuteurs> 

<Ref valeur="MMarais"/> 

</refAuteurs> 
</Oeuvre> 

<Oeuvre ref="liatlc.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref val eur="ThNarcejac"/> 
</refAuteurs> 
</Oeuvre> 
</LesOeuvres> 

<LesAuteurs> 

<Auteur ref="JVernes"> 

<Nom> Jules Vernes </Nom> 
</Auteur> 

<Auteur ref="MMarais"> 

<Nom> Marin Marais </Nom> 
</Auteur> 

<Auteur ref="PBoileau"> 

<Nom> Pierre Bolleau </Noin> 
</Auteur> 
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<Auteur ref="ThNarcejac"> 

<Noin> Thomas Narcejac </Nom> 
</Auteur> 
</LesAuteurs> 



<LesGanimes> 

. . . inuti 1 ise ici . . . 
</LesGammes> 



<LesMarques> 

. . . inuti 1 ise ici . . . 
</LesMarques> 

<LesCaracteri stiques> 

. . . inuti 1 ise ici . . . 
</LesCaracteri stiques> 



</BaseProcluits> 

Le programme XSLT pour obtenir le tableau statiquement ne pose aucune difficulte 
particuliere. II y a une regie par element d'inventaire (livre ou Enegistrement), et 
dans chacunedeces deux regies, on construit unelignedu tableau avec la totalite des 
colonnes. Si une colonne est sans objet pour I'element courant (par exemple un No 
ISBN pour un disque), on instancie une espace non secable, sinon on instancie la 
valeur concernee recuperee plus ou moins simplement dans le document XML, le 
plus complique etant I'lnstanciation des noms d'auteurs. S'il y a plusieurs auteurs ou 
plusieurs interpretes, lis sont tous copies dans la cellule courante du tableau ; par 
contre, s'il y a plusieurs oeuvres dans le meme livre ou le memeenregistrement, seule 
la premiere est prise en compte. 

baseProduits.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transforin" version="1.0"> 



<xsl itempl ate match="/"> 
<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<BODY> 

<xsl :apply-teniplates/> 
</BODY> 
</HTML> 

</xsl :templ ate> 



<xsl itemplate match="LesProcluits"> 
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<table border="l"> 
<tr> 

<th>Produit</th> 
<th>ISBN</th> 
<th>Prix</th> 
<th>Titre</th> 
<th>Auteur</th> 
<th>Interprete</th> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl itempl ate> 

<xsl : tempi ate niatch="Livre"> 
<tr> 

<td>Livre</tcl> 

<td><xsl :value-of sel ect="@NoISBN"/></td> 

<td><xsl : val ue-of sel ect=" . /Prix[@monnaie=' EUR' ]/@valeur"/></td> 
<td> 

<xsl :cal 1 - tempi ate naine="instancier-ti treOeuvre"> 
<xsl iwith-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl :call-teinplate> 
</td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-nomsAuteurs"> 
<xsl :with-param nanie="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl : cal 1 -tempi ate> 
</td> 

<td><xsl :cal 1 -template name="instancier-nbsp"/></td> 
</tr> 
</xsl :templ ate> 

<xsl itemplate niatch="Enregi strement"> 
<tr> 

<td>Disque Compact</td> 

<td><xsl :cal 1 -tempi ate name="instancier-nbsp"/></td> 

<td><xsl : val ue-of sel ect=" . /Prix[@monnaie=' EUR' ]/@valeur"/></td> 

<td> 

<xsl :cal 1 -tempi ate name="instancier-titreOeuvre"> 
<xsl iwith-param name="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl : cal 1 -tempi ate> 
</td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-nomsAuteurs"> 
<xsl iwith-param nanie="refOeuvre" 

sel ect=" ./refOeuvres/Ref [l]/@val eur" /> 

</xsl :call-template> 
</td> 
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<td> 

<xsl :cal 1 -tempi ate name="instancier-interpretes"/> 
</td> 
</tr> 
</xsl :templ ate> 

<xsl itempl ate match="text( ) "/> 

<xsl :teirplate name="instancier-titreOeuvre"> 

<xsl:param nanie="refOeuvre"/> 

<xsl ivariable naine="Oeuvre" 

select="//LesOeuvres/Oeuvre[@ref=$refOeuvre]"/> 

<xsl :value-of select="$Oeuvre/Titre"/> 
</xsl :template> 

<xsl itempl ate naine="instancier-nonisAuteurs"> 
<xsl:param nanie="refOeuvre"/> 
<xsl ivariable name="Oeuvre" 

select="//LesOeuvres/Oeuvre[@ref=$refOeuvre]"/> 
<xsl :for-each select="$Oeuvre/refAuteurs/Ref "> 

<xsl ivariable naine="refAuteur" sel ect="@val eur"/> 
<xsl I vari abl e name="Auteur" 

select="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 

<xsl ivalue-of select="$Auteur/Nom"/> 
<xsliif test="position() last()"><br/></xsl iif> 
</xsl ifor-each> 
</xsl itempl ate> 

<xsl itempl ate name="instancier-interpretes"> 

<xsl ifor-each select="Interpretes/Interprete"> 
<xsl ivalue-of select="@nom"/> 
<xslitext>, </xslitext> 

<xsl ivalue-of select="Role[@xml ilang = 'fr']"/> 
<xsliif test="position() 1 ast( ) "Xbr/X/xsl i i f> 
</xsl ifor-each> 
</xsl itempl ate> 

<xsl itemplate name="instancier-nbsp"> 

<xsl itext disable-output-escap1ng="yes">&</xsl itext>nbsp; 
</xsl itemplate> 

</xsl istylesheet> 

Arrive a cestade, on voit deja que ce n'est pas simple depermuter deux colonnes : il faut 

intervenirdanS leStroiS regies aSSOCieesaUX eiementS Produits, llvre et Enregistrement, 

etpermuter(deiamemefa9on danscestroisendroits) iesiignes source XSLT representant 
unecolonne. 
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Version dynamique 

L'idee d'une generation dynamique, c'est toujours d'interpreter des donnees au lieu de 
les cabler dans le programme. Ici, nous allons done mettre en place un document XM L 
qui va decrire la fa^on dont on veut que les colonnes apparaissent dans le fichier HTM L 
genere. Voici une possibilite parmi d'autres, qui montre un exemple d'un tel fichier : 

Table.xtnl 

<?xml version="1.0" encoding="UTF-16" ?> 
<tabl e id="Li vresEtEnregistreinents"> 

<colonne titre="Produit"> 
<Li vre 

valeur="Livre"/> 
<Enregi strement 

val eur="Compact Disc"/> 
</col onne> 

<colonne titre="Prix"> 
<Livre 

eval=" ./Prix[@monnaie=' EUR' ]/@valeur"/> 
<Enregi strement 

eval . /Prix[@monnaie=' EUR' ]/@valeur''/> 
</col onne> 

<colonne titre="ISBN"> 
<Li vre 

eval="./@NoISBN"/> 
<Enregi strement 

cal 1 =''instancier-nbsp"/> 
</col onne> 

<colonne titre="AuteLir"> 
<Li vre 

cal l=''instancier-nomsAuteurs" 
param=" ./refOeuvres/Ref [l]/@val eur"/> 
<Enregi strement 

cal 1 ^'instancier-nomsAuteurs" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
</col onne> 

<colonne titre="Titre''> 
<Li vre 

cal 1 ^'instancier-ti treOeuvre" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
<Enregi strement 

cal 1 ^'instancier-ti treOeuvre" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 
</col onne> 
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<colonne titre="Interprete"> 
<Livre 

call="instancier-nbsp"/> 
<Enregistrement 

cal 1 ="instancier-interpretes"/> 
</col onne> 
</table> 

Ce document decrit une table qui contiendra des livres et des enregistrements, donne 
I'ordre des colonnes, et decrit, pour cliaque element <Livre> ou <Enregistrement> du 
document source principal, la fagon d'aller y recuperer les donnees. 

Certainesdonnees, fournies par I'attribut vaieur, sont a prendre tell es quel les : par exem- 
ple, la colonne Produit contient iivre pour un <Livre>, ou compact Disc pour un 
<Enregistrement> : 11 n'y a donc pas de donnees a aller chercher dans ce cas. 

D'autres donnees sont des expressions X Path a interpreter ; ce sont eel les qui sont four- 
nies par I'attribut evai. A I 'execution, 11 faudra donc interpreter dynamiquement ces 
expressions/ Path, et c'est la qu'interviendra la fonction d'extension evaiuate( ), dispo- 
nibleavec le processeur Saxon ou Xalan. 

Enfin certaines donnees sont obtenues par un cheminement trop complique pour etre 
exprime directement par une expression XPath ; dans ce cas on donne le nom d'un 
modele nomme qu'il faudra executer (attribut cai i), eton lui transmeteventuellement un 
parametre (attribut param). Si I'attribut param est present, il contient une expression 
XPath qu'il faudra interpreter. 

Le fait d'avoir commence par la version statique permet d'anticiper les difficultes 
d'acces aux donnees : en particulier, on salt que la recuperation des noms d'auteurs 
n'est pas simple, car il peuty en avoir plusieurs par oeuvre, ce qui implique une bou- 
cle <xsi :for-each> (d'ou I'appel a un modele nomme). Notons en passant que 
I'appel d'un modele nomme dont le nom est contenu dans une variable est interdit en 
XSLT : la encore, il faudra faire appel a une extension, qui rend possible I'utilisation 
d'un descripteur de vaieur differee pour I'attribut name de I'instruction <xsi :caii- 

templ ate>. 

Ceci etant, ce fichier de description doit permettre de changer I'ordre d'apparition des 
colonnes dans le tableau, tout simplement en permutant les deux elements correspon- 
dants. Ce n'est d'ailleurs pas la seule fagon : on peut aussi laisser ce fichier intact et 
transmettre le nom et I'ordre des colonnes au programme d'interpretation, mais nous 
verrons cette deuxieme sol uti on pi us I oi n. 

II est Clair que ce fichier apporte plus de souplesse que la simple permutation facile de 
colonnes: il est tres facile, par exemple, d'ajouter un nouvel element a prendre en 
compte dans I'inventaire, si toutefois une simple expression X Path peut en venir a bout. 
S'il fautun modele nomme, cela implique une modification du programme pour y ajouter 
ce modele nomme. 
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Pattern 

Le pattern consiste a mettre en place I'enchainement suivant, que I 'on va maintenant 
expliciter sur un exemple. 

Etape 1 : traitement d'un element qui doit figurer dans le tableau. Par exemple, traite- 
ment d'un element <Livre> du document source principal (baseProduits.xmi). Cet 
element est mis dans un node-set ei ementcourant ne contenant que cet element, 

Etape 2 : constitution d'un node-set ei ementsPi 1 otes contenant tous les elements 
<Livre> du document Table. xmi. Ce node-set est appele EiementsPiiotes parce qu'il 
contient effectivement des elements, et que ces elements pilotent le processus de recupe- 
ration des donnees i nteressantes. Dans notre exemple, ce node-set contient tous les 
<Livre> du document Tabi e .xmi , et pour chacun d'eux on trouvesoitun attribut vaieur, 
soit un attribut evai, soit un attribut can, qu'il va falloir interpreter. 

Etape 3 : constitution du texte de I'expression permettant I'acces a la donnee, et inter- 
pretation dynamique de ce texte d'expression. 

Etape 3A : cas de I'attribut vaieur, qui est le plus simple. En effet, il n'y a rien de parti- 
culler a faire dans ce cas, si ce n'est de prendre en compte la vaieur fournie. 

Etape 3B : cas de I'attribut evai, qui est le plus typique. On recupere une chatne de 
caracteres, par exemple ./Prix[@monnaie='EUR']/@vaieur. Cette chaine de caracteres 
doit etre rapprochee de I 'element courant <Livre> contenu dans le node-set ei ement- 
courant. En effet, I'expression a interpreter est 

I $ El ementcourant/ . /Prix[@monnaie=' EUR' ]/@val eur 

Le '/./' median amene une redondance, mais qui est inoffensive (et que I'on pourrait 
facilement supprimer). Le texte de cette expression resulte de la concatenation des trois 
chaines de caracteres : 

'$E1 ementcourant' 
■/' 

. /Prix[@monnaie=' EUR' ]/@val eur 

Les deux premieres sont des chaines litterales, et la derniere est la vaieur de I'attribut 
evai de I'elementpilote courant, desorte quel 'appel alafonction concato correspondant 
va s'ecrire : 

I concatC '$ElementCourant' , '/', @eval) 

Eta I'executi on, cet appel va fournir I'expression : 

I $E1 ementcourant/ ./Prix[@monnaie=' EUR' ]/@val eur 

Dans cet exemple, n'oublions pas que ei ementcourant estun node-set ne contenant que 
le <Livre> du document principal en cours de traitement. De sorte que cette expression, 
si on I'interprete, donne la vaieur du prix en euros du <Livre> courant, etc'estbien cette 
vaieur qu'il fallait recuperer pour la placer dans une cellule de tableau. 
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L'evaluation se fait par appel d'une fonction d'extension, fournie par Saxon et Xalan. 
Avec Saxon, I 'appel prend la forme suivante : 

saxon :eval uate( 

concatC '$EleinentCourant' , '/', @eval) 

) 

Etape3C : cas de I'attribut caii, avec presence d'un attribut param, par exemple : 

I<Livre 
cal 1 ="instancier-nomsAuteurs" 
param=" . /refOeuvres/Ref [l]/@val eur"/> 

1 1 faut a nouveau rapprocher la chaine fournie par I 'attri but param de I 'element courant du 
document source principal ; on opere done la concatenation des trois chaines : 

'SElementCourant' 
I ./refOeuvres/Ref[l]/@valeur 

Les deux premieres sont des chatnes litterales, et la derniere est la valeur de I'attribut 
param del'element pilote courant, desortequel'appel a la fonction concat( ) correspondant 
va s'ecrire : 

I concat( '$ElementCourant' , '/', ©param) 

Eta I'execution, apres evaluation par la fonction saxonievaiuateo, cet appel va fournir 
I 'expression : 

$E1 ementCourant/ ./refOeuvres/Ref [l]/@val eur 

Dans cet exemple, n'oublions pas que Eiementcourant est un node-set ne contenant que 
le<Livre> du document principal en cours detraitement. De sorte que cette expression, 
si on I'interprete, donne la valeur de la premiere reference d'oeuvre du <Livre> courant, 

Cette valeur va done jouer le role d'argument pour I'appel du modele nomme dont le 
nom est la valeur de I'attribut cai i de I'element pilote. 

Quant a I'appel proprement dit du modele nomme, 11 doit prendre une forme speciale, 
parce qu'en XSLT standard, un tel appel est impossible. En effet, le nom du modele a 
appeler n'est pas ici connu statiquement, chose qu'XSLT interdit. Pour pouvoir tout de 
meme appeler ce modele, 11 faut done utiliser une forme ou un descripteur de valeur dif- 
feree d'attribut est autorise, ce qui constitue une extension au langage, fournie par Saxon 
de la maniere suivante : 

<xsl icall-template name=" {Stname} " saxon:allow-avt="yes"> 

On peutmaintenantdonner le programmed' interpretation de la specification de disposition 
du tableau. 

baseProduits.xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl :stylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transform" 
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xmlns:saxon="http://icl .com/saxon" 
extension -el ement-pref ixes="saxon" 
version = "1.0"> 

<xsl:output inethod='html ' encoding=' ISO-8859-r /> 

<xsl :variable 

name="tableLi vresEtEnregistrements" 

select="document( 'Table.xml ' )/tabl e[@id=' Li vresEtEnregistrements ' ]"/> 

<xsl :variable 

naine="racineDocumentPrincipal " 
select="/"/> 

<xsl : tempi ate match="/"> 
<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<BODY> 

<xsl :apply-teinplates/> 
</BODY> 
</HTML> 
</xsl itempl ate> 

<xsl itemplate match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl :cal 1 - tempi ate naine="instancier-titresColonnes"/> 
</tr> 

<xsl :apply-teinplates/> 
</table> 
</xsl itempl ate> 



<!-- 

Etape 1 

<xsl itempl ate match="Livre"> 
<tr> 

<xsl :cal 1 -tempi ate name="instancier-col onnes"/> 
</tr> 
</xsl itempl ate> 

<!-- 

Etape 1 

<xsl itempl ate match="Enregi strement"> 
<tr> 
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<xsl : call -tempi ate nanie="instancier-colonnes"/> 
</tr> 
</xsl :templ ate> 

<!-- 

====================================================== --> 

<xsl itempl ate match="text( ) "/> 



<!-- 



Fin des regies 

====================================================== --> 

<xsl itemplate name="instancier-titresColonnes"> 

<xsl :for-each select="$tabl eLi vresEtEnregistrements/col onne"> 
<th><xsl :value-of select="@titre"/></th> 

</xsl :for-each> 
</xsl itempl ate> 

<! > 

<xsl itemplate name="instancier-colonnes"> 
<!-- 

Comme ce modele est appele depuis une regie sans xsl :for-each, 
1 'element courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 
--> 

<xsl ivariable name="El ementCourant" select="current( )"/> 
<xsl ivariable name="El ementName" select=''l ocal -name( )"/> 



<!-- 

Etape 2 

= : = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = --> 

<xsl ivari abl e 

name='' Elements Pi lotes" 
select="saxonieval uate( 
concat( 

' $tabl eLi vresEtEnregi strements/col onne/ ' 
$E1 ementName 

) 

)" 

/> 
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Valeur de la variable SElementsPilotes dans notre exemple : 



cas ou $ElementCourant est un <Livre> 



<Livre valeur="Livre"></Livre> 

<Li vre eval =" ./Prix[@monnaie=' EUR' ]/@val eur"></Li vre> 
<Livre eval="./@NoISBN"></Livre> 

< Li vre cal 1 ="instancier-nomsAuteurs" 

param=" . / refOeuvres/Ref [l]/@val eur'X/Li vre> 

< Li vre cal 1 ="instancier-ti treOeuvre" 

param^" . / refOeuvres/Ref [l]/@val eur-X/LI vre> 

<Li vre cal 1 ="instancier-nbsp"></Li vre> 



cas oCi $ElementCourant est un <Enregi strement> 



<Enregistrement val eur="Compact Disc"></Enregistrement> 
<Enregistrement eval =" . /Prix[@monnaie=' EUR' ]/@valeur"> 
</Enreg1strement> 

<Enregistrement cal 1 = "instancier-nbsp''></Enreg1strement> 

<Enregistrement cal 1 ^'instancier-nomsAuteurs" 

param=" . /refOeuvres/Ref [l]/@val eur"> 
</Enreg1strement> 

<Enregi strement cal 1 ^'instancier-titreOeuvre" 

param='' . / refOeuvres/Ref [l]/@val eur"> 
</Enregistrement> 

<Enregi strement cal 1 ^'instancier-interpretes") 
</Enreg1strement> 
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<!-- 



--> 



<!-- 



Etape 3 



> 



<xsl :for-each select="$ElementsPilotes"> 
<td> 

<xsl :choose> 
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<!-- 

Etape 3A 

<xsl iwhen test="@val eur"> 

<xsl :value-of select="@valeur"/> 
</xsl :when> 

<!-- 

Etape 3B 



<xsl :when test="@eval "> 

<xsl :value-of select="saxon:evaluate( 
concat( 'SElementCourant' , '/', @eval ) 

)"/> 
</xsl :when> 



<!-- 

Etape 3C 

====================================================== --> 

<xsl :when test="@cal 1 "> 

<xsl :choose> 

<xsl :when test="@param"> 
<xsl : call -tempi ate 

name="{@call )" saxon:allow-avt="yes"> 
<xsl :with-param 

name="refOeuvre" 
select="saxon:eval uate( 

concat( '$ElementCourant' , 

' / ' , @param) 

)"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl icall-template 

name="{@call }" saxon:allow-avt="yes"> 
<xsl :with-param 

name="ElementCourant" 
sel ect="$El en)entCourant"/> 
</xsl :call-template> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :when> 
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</xsl :choose> 
</td> 
</xsl : for-each> 
</xsl :templ ate> 

<! > 

<xsl itemplate name="instancier-titreOeuvre"> 
<xsl:parain naine="refOeuvre"/> 
<xsl :variable 

name="Oeuvre" 

sel ect=" 

$racineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre] "/> 
<xsl :value-of select="$Oeuvre/Titre"/> 
</xsl :templ ate> 



<! > 

<xsl itemplate name="instancier-nomsAuteurs"> 
<xsl:parain name="refOeuvre"/> 
<xsl ivariable 

name="Oeuvre" 

sel ect=" 

SracineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre]"/> 
<xsl :for-each select="$Oeuvre/refAuteurs/Ref"> 

<xsl ivariable name="refAuteur" sel ect="@val eur"/> 
<xsl ivariable 

nanie="Auteur" 

sel ect="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 
<xsl ivalue-of sel ect="$Auteur/Noin"/> 
<xsliif test="position() != last( )"><br/></xsl iif> 
</xsl ifor-each> 
</xsl itempl ate> 



<! > 

<xsl itemplate name="instancier-interpretes"> 
<xsl iparam naine="El ementCourant"/> 

<xsl ifor-each sel ect="$ElementCourant/Interpretes/Interprete"> 
<xsl ival ue-of sel ect="@nom"/> 
<xslitext>, </xslitext> 

<xsl ivalue-of select="Role[@xml ilang = 'fr']"/> 
<xsliif test="position( ) != last( )"><br/></xsl iif> 
</xsl ifor-each> 
</xsl itempl ate> 



<! > 

<xsl itemplate name="instancier-nbsp"> 
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<xsl :text disable-output-escaping="yes">&amp:</xsl :text>nbsp; 
</xsl :templ ate> 

</xsl :stylesheet> 

Un element qu'il fauttoujours prendre en compte, pour I'instanciation d'un model e, c'est 
que le contexte d'evaluation ne change pas de I'appelant a I'appele : or, ici, certains des 

modeleS nommeS (instancier-nomsAuteurs, i nstanci er-i nterpretes, par exemple) 

sont appeles a I'interieur de la boucle sur les elements pilotes (etape 3). Cette boucle 
change le contexte d'evaluation : en particulier le noeud courant est un element pilote, 
done un element du document XML Table. xmi. Or le modele nomme instancier- 
nomsAuteurs, par exemple, evalue I 'expression XPath 

I //LesOeuvres/Oeuvre[@ref=$refOeuvre] 

Si Ton ne fait rien de particulier, cette expression sera done evaluee par rapport a un 
noeud contexte situe dans le document Table. xmi, ce qui n'a evidemment aucun sens. II 
est done necessaire de retrouver le document principal lors de I 'evaluation de cette 
expression, cequi est rendu possible par la variable globale racineDocumentPrincipai . 

A I'execution, les colonnes du tableau s'affichent dans I'ordreou elles apparaissent dans 
le document Tabi e.xmi (voir figure 9-7). 



Figure 9-7 

U n tableau dont les 
colonnes (ordre et 
contenu) sont 
spedfiees a part. 
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II est vrai que la solution obtenue peut ne pas resoudre tout a fait le probleme pose : en 
effet, puisque I'utilisateur peut dynamiquement demander une permutation de I 'ordre de 
presentation des colonnes, 11 faut pouvoir repercuter cette demande sur le document 
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Tabie.xmi, et permuter en consequence les deux elements correspondants. C'estevidem- 
ment trivial a realiser en XSLT, mais peut-etre n'est-ce pas la solution que I'on souhaite- 
rait. Une autre solution, plus dynamique, consisterait a indiquer au programme 
d' interpretation (baseProduits.xsi) I'ordre des colonnes souhaite, sous la forme d'un 
parametretransmis lorsdel'appel : 

Ligne de comtnande (d'un seul tenant) 

Java -classpath "C:\Prograni Files\JavaSoft\SAXON\saxon.jar;" 
com. icl .saxon. Stylesheet -o baseProduits.html BaseProduits.xml BaseProduits .xsl 
ordreColonnes="Produit Prix Auteur Titre ISBN Interprete" 

Dans ce cas, le document labi e .xmi ne sert plus a determi ner I 'ordre des colonnes, mais 
seulement a specifier I'acces aux donnees. On pourrait aussi choisir une option mixte 
dans laquelle ce document XM L donne I'ordre des colonnes par defaut, en I'absence du 
parametre ordreCol onnes lors du lancement du processeur. 

Pour obtenir le resultatcherche, il n'y a assez peu de modifications a apporter, car le pat- 
tern reste essentiellement le meme; mais au lieu de boucler sur les elements pilotes 
(etape 3), il faut boucler sur les elements fournis par le parametre ordreCoi onnes. 

C'est d'ailleurs une occasion d'utiliser encore une nouvel I e extension, car on salt qu'une 
boucle <xsi :for-each> est adaptee uniquement au parcours de node-sets ; or justement, 
il existe une extension Saxon (ou Xalan) qui transforme une suite de lexemes en un node- 
set d'elements dont les valeurs textuelles sont les lexemes fournis : il s'agit de la fonction 
saxon : tokeni ze( ), que I'on utilisera done a cettefin, 

baseProduits .xsl 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl istylesheet 

xmlnsixsl = "http://www.w3.org/1999/XSL/Transforin" 

xmlns:saxon="http://icl .com/saxon" 

extension -el einent-prefixes=" saxon" 

version = "1.0"> 

<xsl:output method^'html ' encoding=' ISO-8859-r /> 

<xsl iparam 

naine=" ordreCol onnes" 

select=" ' Produit Prix Auteur Titre ISBN Interprete' "/> 
<!-- donne I'ordre par defaut des colonnes --> 

<xs1 ivariable 

name="tableLi V res Et En regis trements" 

select="document( 'Tables.xml ' )/table[@id=' LivresEtEnregistrements ']"/> 

<xsl :variable 

naine="racineDocumentPrincipal " 
select="/"/> 

<xsl : tempi ate match="/''> 
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<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<BODY> 

<xsl :apply-teniplates/> 
</BODY> 
</HTML> 
</xsl :templ ate> 

<xsl :template match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl :cal 1 - tempi ate nanie="instancier-ti tresCol onnes"/> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :template> 

<!-- 



Etape 1 

====================================================== --> 

<xsl itempl ate match="Livre"> 
<tr> 

<xsl : cal 1 -tempi ate name="instancier-colonnes"/> 
</tr> 
</xsl :templ ate> 
<!-- 



Etape 1 

====================================================== --> 

<xsl itempl ate match="Enregistrement"> 
<tr> 

<xsl : cal 1 -tempi ate name="instancier-col onnes"/> 
</tr> 
</xsl :templ ate> 

<!-- 

====================================================== --> 

<xsl :template match="text( ) "/> 



<!- 



Fin des regies 
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<xsl itemplate name="instancier-titresColonnes"> 

<xsl :for-each select="saxon:tokenize( SordreCol onnes )"> 

<th><xsl :value-of sel ect=" . "/></th> 
</xsl :for-each> 

</xsl :templ ate> 

<! > 

<xsl :template name="instancier-colonnes"> 
<!-- 

Comme ce modele est appele depuis une regie sans xsl :for-each, 
I'eleinent courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 
--> 

<xsl ivariable name="ElementCourant" sel ect="current( ) "/> 
<xsl ivariable name="ElementNaine" sel ect="l ocal -name( ) "/> 

<!-- 



Etape 3 

====================================================== --> 

<xsl ivariable 

name^-LesNomsDeCol onnes" 

select="saxon:tokenize( $ordreColonnes )"/> 

<xsl :for-each sel ect="$LesNomsDeCol onnes''> 



<xsl ivariable 

nanie="NomDeLaCol onneEnCours" 
sel ect=" . "/> 

<xsl ivariable 

nanie=" El ementPi 1 ote" 
sel ect="saxonieval uate( 
concat( 

' StableLi vresEtEnregi strements/col onne[ 
@titre=&#34: ' . 

$NomDeLaCol onneEnCours, '&#34:]/' , 
$E1 ementName 

) 

)" 

/> 

<xsl ifor-each select="$ElementPilote"> 
<td> 

<xsl ichoose> 
<!-- 



Etape 3A 

=============================== --> 
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<xsl :when test="@val eur"> 

<xsl :value-of select="@valeur"/> 
</xsl :when> 



<!- 



Etape 3B 



<xsl :when test="@eval "> 

<xsl :value-of select="saxon:evaluate( 
concat( 'SElementCourant' , '/', @eval ) 

)"/> 
</xsl :when> 



<!- 



Etape 3C 



<xsl :when test="@cal 1 "> 

<xsl :choose> 

<xsl :when test="@param"> 
<xsl icall-template 

name="{@call }" saxon:allow-avt="yes"> 
<xsl :with-parain 

name="refOeuvre" 
select="saxon:eval uate( 

concatC ' $E1 ementCourant ','/', @param) 
)"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl icall-template 

name="{@call )" saxon:allow-avt="yes"> 
<xsl :with-param 

name=" El ementCourant" 
sel ect="$El ementCourant "/> 
</xsl :call-template> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :when> 



</xsl :choose> 
</td> 

</xsl :for-each> 
</xsl :for-each> 
</xsl :template> 
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<! > 

<xsl :template name="instancier-titreOeuvre"> 
<xsl:parain naine="refOeuvre"/> 
<xsl :variable 

name="Oeuvre" 

sel ect=" 

$racineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre] "/> 
<xsl :value-of select="$Oeuvre/Titre"/> 
</xsl itempl ate> 

<! > 

<xsl itemplate name="instancier-nomsAuteurs"> 
<xsl:parain naine="refOeuvre"/> 
<xsl ivariable 

name="Oeuvre" 

sel ect=" 

$racineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$refOeuvre] "/> 
<xsl :for-each sel ect="$Oeuvre/refAuteurs/Ref "> 

<xsl ivariable name="refAuteur" sel ect="@val eur"/> 
<xsl ivariable 

nanie="Auteur" 

sel ect="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 
<xsl :value-of sel ect="$Auteur/Nom"/> 
<xsl:if test="position() != last( )"><br/></xsl :if> 
</xsl :for-each> 
</xsl :templ ate> 

<! > 

<xsl itemplate name="instancier-interpretes"> 
<xsl iparam naine="El ementCourant"/> 

<xsl :for-each sel ect="$El ementCourant/Interpretes/Interprete"> 
<xsl :val ue-of sel ect="@noin"/> 
<xsl:text>, </xsl:text> 

<xsl :val ue-of select="Role[@xml :lang = 'fr']"/> 
<xsl:if test="position() != last( )"><br/></xsl :if> 
</xsl : for-each> 
</xsl :templ ate> 

<! > 

<xsl :template name="instancier-nbsp"> 

<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp: 
</xsl itempl ate> 

</xsl :stylesheet> 
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L'etape 2 a disparu, puisque cette etape consistait dans la version precedente a rassem- 
bler les elements pilotes dans un node-set, chaque element pilote correspondant a une 
colonne. Ici, c'est inutile, puisque la liste des colonnes est deja connue au travers de la 
variable ordreCoionnes. L'etape 3 se transpose done ici en un parcours du node-set 
LesNomsDeCoionnes construit a partir de cette liste, le node-set en question etant par 
contre constitue de noeuds completement deconnectes du document Tabie.xmi. Done 
pour avoir un element pilote a partir du NomDeLaCoionneEnCours, 11 faut effectuer une 
recherche de cet element pilote dans le document Table. xmi connaissant le nom de la 
colonne courante, et I'element a traiter (<Livre> ou <Enregistrement>). Cette recherche 
est effectuee par I 'expression X Path initial isant la variable EiementPiiote. 

Cette expression X Path est construite a partir des donnees suivantes : 

• $NomDeLaCoionneEnCours : une chaine de caracteres donnant le nom de la colonne 
(par exemple 'Prix') ; 

• $EiementName : une chaine de caracteres donnant le nom de I'element (du document 
principal) en coursdetraitement (par exemple 'livre'), 

Avec ces donnees, il faut construi re I 'expression suivante : 

$tableLivresEtEnregistreinents/colonne[@titre="Pr7;<"]//.7vre 

Dans cette expression, tout est constant, sauf les deux noms indiques en gras, qui sont des 
valeurs de variables. On peut done construi re une chaine de caracteres contenant 
I 'expression ci-dessus, par concatenation de constantes litterales et de valeurs de varia- 
bles, maisil resteleproblemedesguillemets. On utilise ici des entites caracteres pour les 
representer (&#34:), car sous forme litterale, ils entreraient en conflit avec ceux utilises 
pour delimiter I'attribut select contenant I 'expression a evaluer, ou avec les delimiteurs 
dechaines litterales de la fonction concatc ). 

Unefois I 'expression construite, il n'y a plus qu'a I 'evaluer, cequi sefaitcommed'habi- 
tudeparappel a la fonction s axon : eval uate( ). 

Le resultat de cette evaluation est un node-set ne contenant qu'un seul element : un 
element pilote du document Table, xmi . Cet element pilote doit maintenant devenir le 
noeud courant, pour nous ramener a la version precedentedu programme, ou il y avait 
une boucle sur un node-set d'elements pilotes. C'est la raison de la presence du for- 
each suivant, qui ne sert pas a effectuer une boucle (puisque de toute fa^on, on est 
certain que le node-set a parcourir ne comporte qu'un seul element), mais sert uni- 
quement a changer de contexte d'evaluation (voir la section Autre semantique, 
page 140). 

Unefois que le noeud courant est un element pilote, le reste du programme est essentiel- 
lement identique a celui de la version preCedente, et le resultat obtenu est montre a la 
figure 9-8. 
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Figure 9-8 

Permutation des 
colonnes specifiee 
lors de I 'appel du 
programme. 
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Pattern n° 20- Generation de documents multiples 

Ce pattern va donner un example de generation de documents multiples, pour lequel le 
resultat obtenu ne sera done pas un seul fichier, mais plusieurs, ce qui permettra par 
exemple a une application de produire tout un ensemble de pages HTML liees les unes 
aux autres par des liens actifs. 

Nous allons prendre I 'exemple d'un document XM L representant un support de cours, 
divise en pages, commececi : 

XMLXSL.xml 

<?xnil version="1.0" encoding="IS0-8859-l" ?> 
<presentation titre="Cours XML"> 



<pageDeTitre id="XML.O" nextPage="XML. 1"> 

<titrePresentation>Comprenclre XML et XSL</titrePresentation> 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="XML.l" previousPage="XML.O" nextPage="Tabl e"> 
<titrel id="XML.l.Derouleinent">Deroulement du Cours</titrel> 
<blocl> 
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<item> 

Le cours XML se deroule de 9h30 a 12h30 et de 14h a 17h30. 
</item> 
<bloc2> 
<itein> 

Pauses-cafe a llh et 16h. 

</iteni> 

<item> 

Discussions libres pendant le dejeuner et apres 17h30. 
</item> 
</bloc2> 
</blocl> 
<blocl> 
<itein> 

Le dernier jour, foire aux questions de 16h30 a 17h30. 
</item> 
</blocl> 
</pageStandard> 

<plan id="Table" previousPage="XML.l" nextPage="XML.2"/> 

<pageStandard id="XML.2" previousPage="Table"> 

<titrel id="XML.2generar'> XML - Generalites </titrel> 
<blocl> 
<itein> 

XML est un langage de balisage de textes. 
</iteni> 
</blocl> 

<titre2 id="XML.2.balisage"> Balisage </t1tre2> 
<blocl> 
<itein> 

Le principe d'un langage de balisage de textes existe depuis 
fort longtemps, 

avant meme 1 'invention de 1 ' informatique. 
</item> 
<bloc2> 
<item> 

en imprimerie. le texte de I'epreuve est balisee de 
"corrections" a effectuer (balises textuelles), 
</item> 
<item> 

et les relectures a voix haute, chez les typographes, 

se font agrementees de balises vocales codifiees, avec tout un 

argot de metier assez savoureux (trouve dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques Andre, 

in Cahier GUTemberg No 31, Decembre 1998) : 

</item> 
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<bloc3> 
<item> 

le metro (invente par Bienveniie ! ...) 

</item> 

<item> 

le metro <texteImportant>ouvre</texteImportant> invente 
par Bienveniie <texteImportant>cap couilles clame suce ferme 
</texteImportant> 
</item> 
</bloc3> 



<item> 

Avec 1 'invention de 1 'informatique, les techniques de balisages 
se sent appliquees a la commande des Linotypes par bandes 
perforees, ou le texte a composer etait parseme de commandes 
destinees a la manoeuvre de la Lynotype elle meme (passer en gras, 
changer de corps, faire un retrait, etc.). 



</item> 
</blocl> 
</pageStandard> 

</presentation> 

Le but est done d'obtenir une serie de pages HTM L, une par <pagestandard>, <pageDe- 
Titre>, OU <pian> du document XML. Le nom de chaque fichier resultat sera forme 

d'apreS I'attribut id de chaque <pageStandard>, <pageDeTitre>, OU <plan>, auquel On 

ajoutera lesuffixe ' .htmi '. 

Done dans le notre exemple, on obtiendra au final les fichiers XML.o.htmi, XML.i.htmi, 
tabie.html, et XML. 2. html (voir figures 9-9 a 9-12). 



</bloc2> 



</blocl> 
<blocl> 



Figure 9-9 

Premiere page. 




D 



Fichier Edition Affichage Favoris Outils 



Table 



Page suivante 



Comprendre XINIL et XSL 



Philippe Drix 



OBJECTTVA 



Ph. Drix - Objectiva Comprendre XML et XSL 



Patterns de transformation 

Chapitre 9 



Figure 9-10 

Deuxieme page. 
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Le coeur du programme est constitue d'un modele nomme qui instancie les pages HTML 
suivant un format pre-determine : en-tete, corps de page, pied de page. L'en tete est en 
fait une barre de navigation permettant de passer de page en page en avant ou en arriere, 
ou d'aller directement a la table des matieres : 

<xsl itemplate naine="instancier-page"> 

<xsl:param name="f i 1 eName"/> 
<xsl:param name="next"/> 
<xsl:param name="prev"/> 

<xsl idocument href="{$fileNaine}"> 

<xsl :call-teinplate name="instancier-entete"> 

<xsl :with-param name="next" sel ect="concat( $next, '.html')" /> 
<xsl :with-param name="prev" sel ect="concat( $prev, '.html')" /> 
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Figure 9-12 

Troisieme page. 
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1 effectuer (balises textuelles), 

o etles relectiores avoixhaute, chezles typographes, sefont 
agrementees de balises voc ales codifiees, avec tout un argot de 
metier ass ez savoureux(tfouve dans Petite Histoire des signes 
de conections typographiques", par Jacques Andre, inCaliier 
GUTembergNo 31, Decembre 1998) : 

■ le metro (invente par Bienvenue ! ...) 

■ le metro ouvre invente per Eienvenue cap couilles clante 
suce ferme 






• Avec I'invention de I'infotmatique, les techniques de balisages se sont 
applique es a la comniande des Linotjfpes parbandes perforees, oiile 
tejde a composer etaitparseme de commandes destine es a la manoeuvre 
de la Lynotjrpe elle meme (passer en gras, changer de corps, faire un 
retrait, etc.). 
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</xsl : call -tempi ate> 

<TABLE wiclth="100%" height="90^" BORDER="0" CELLSPACING="10"> 
<TR valign="top"><TD> 

<xsl :apply-teinplates/> 
</TD></TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</xsl :document> 

</xsl :templ ate> 

L'instruction <xsi : document href="...">, utilisee ci-dessus, permet de diriger la 
Serialisation de son modele de transformation vers un fichier dont I'URI est fourni par 

I'attribut href. 
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Cette instruction n'est pas une instruction du langage XSLT 1.0, qui ne fournit aucun 
moyen standard de creer plusieurs ficliiers resultats. II est done necessaire, ici, d'utiliser 
une extension, qui se trouve disponible par exemple dans Xalan (sous une forme tres 
differente de celle qui est montree ci-dessus). 

L ongtemps el le a ete aussi proposee par le processeur Saxon (mais sous une forme lege- 
rement differente de la version ci-dessus). Puis le Working Draft 1.1 est paru, et a pro- 
pose une evolution permettantjustement la creation de plusieurs fichiers resultat, sous la 
forme montree ci-dessus. M ichael Kay a alors implemente la nouvelle forme proposee, 
cequi faitqu'il estpossibledel'utiliser commesi c'etait une instruction normale(etnon 
pas une extension), a condition d'indiquer au moins 1.1 comme numero de version de 
langage XSLT, 

Signalons pour terminer que I'extension proposee par Xalan peut etre plus pratique dans 
certains cas; elle se decompose en trois fonctions: xaian:open( ), xaianiwriteo, et 
xaian:ciose( ). Cela permet de constituer un fichier petit a petit, alors qu'avec I 'instruc- 
tion xsi rdocument, 11 faut le constituer d'un seul coup en un seul bloc. Si done plusieurs 
instructions xsi :document sont executees avec le meme nom de fichier, le fichier est 
ouvert et referme a chaque fois, et chaque ecriture ecrase la precedente. Au contraire, 
avec I'extension proposee par Xalan, 11 estfaciledecreer un fichier par ajoutssuccessifs, 
par exemple pour conserver une trace de I'execution d'un programme XSLT, lorsqu'on 
recherche la cause d'une erreur coriace a detecter. 

Voici maintenant le programme, qui ne met rien en oeuvre qui n'ait deja ete vu. 

XMLXSL.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl : stylesheet xmlns: xsi =" http://www.w3.org/1999/XSL/Transform" 
version="l.l"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output method^'html ' encoding='IS0-8859-r /> 



<!-- 

====================================================== --> 

<xsl itemplate match="pageDeTitre"> 

<xsl : call -tempi ate name="instancier-page"> 

<xsl :with-param name="fileName" sel ect="concat( @id, '.html' )" /> 
<xsl :with-param name="next" sel ect="@nextPage" /> 
</xsl :call-template> 
</xsl :templ ate> 

<xsl itempl ate match=''titrePresentation"> 

<H1 al ign="center''><xsl :val ue-of select='' . "/></Hl> 
</xsl :templ ate> 

<xsl :templ ate match=''auteur"> 

<H2 align="center"><xsl :value-of select=" . "/></H2> 
</xsl :templ ate> 
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<xsl itemplate match="societe"> 

<H2 align="center"><xsl :value-of sel ect=" . "/></H2> 
</xsl :templ ate> 

<!-- 

====================================================== --> 

<xsl rtemplate match="pageStanclard"> 

<xsl :call-template naine="instancier-page"> 

<xsl :with-param nanie="f i 1 eName" sel ect="concat( @id, '.html' )" /> 
<xsl :with-param nanie="prev" select="@previousPage" /> 
<xsl :with-param nanie="next" sel ect^'enextPage" /> 
</xsl : call -tempi ate> 
</xsl itempl ate> 

<xsl : tempi ate match="titrel"> 

<H1 align="left"><xsl :value-of sel ect=" . "/></Hl> 
</xsl :templ ate> 

<xsl :template match="titre2"> 

<H2 align="left"><xsl :value-of sel ect=" . ''/></H2> 
</xsl itempl ate> 

<xsl itemplate match="bl ocl''> 

<UL TYPE="SQUARE"><xsl :apply-templates/></UL> 
</xsl itempl ate> 

<xsl itemplate match="item''> 

<LI><xsl iapply-templates/></LI> 
</xsl itempl ate> 

<xsl itemplate match="bl oc2"> 

<UL TYPE=''CIRCLE"><xsl iapply-templates/></UL> 
</xsl itempl ate> 

<xsl itemplate match="bl oc3''> 

<UL TYPE^'DISCXxsl i apply-templ ates/></UL> 
</xsl itempl ate> 

<xsl itemplate match="texteImportant"> 

<B><xsl iapply-templates/></B> 
</xsl itemplate> 

<!-- 

====================================================== --> 

<xsl itemplate match="pl an''> 

<xsl ical 1 -tempi ate name="instancier-pl an"> 

<xsl iwith-param name^'f i 1 eName" sel ect="concat( @id, '.html' )" /> 
<xsl iwith-param name="prev" select="@previousPage'' /> 
<xsl iwith-param name="next" sel ect^'SnextPage" /> 
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</xsl :call-teniplate> 
</xsl :templ ate> 



<xsl itempl ate match="titrel" mocle="plan"> 
<H1 align="left"> 

<A HREF="{concat(parent: :*/@id, '.htnir))"> 
<xsl :value-of select="."/> 
</A> 
</Hl> 
</xsl :templ ate> 

<xsl :templ ate match="titre2" niocle="pl an"> 
<H2 align="left"> 

<A HREF="{concat(parent: :*/@id, '.html'))"> 
<xsl :value-of select="."/> 
</A> 
</H2> 
</xsl :templ ate> 

<xsl itemplate match="text( ) " mocle="plan"/> 
<!-- 

====================================================== --> 

<!-- --> 

<xsl itempl ate naine="instancier-page"> 

<xsl:param name="f i 1 eName"/> 
<xsl:parain name="next"/> 
<xsl:parain name="prev"/> 

<xsl :document href="{$fileNaine}"> 
<HTML> 

<HEAD> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<BODY> 

<xsl : call -tempi ate nanie="instancier-entete"> 

<xsl iwith-param name="next" sel ect="concat( $next, '.html')" /> 
<xsl iwith-param name="prev" sel ect="concat( $prev, '.html')" /> 

</xsl :call-template> 

<TABLE width="100%" height="90^" BORDER="0" CELLSPACING="10"> 
<TR val ign="top"><TD> 

<xsl :apply-templates/> 
</TD></TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</BODY> 
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</HTML> 

</xsl :document> 
</xsl itempl ate> 
<!-- --> 

<xsl :template name="instancier-entete"> 

<xsl:parain naine="next"/> 
<xsl:parain naine="prev"/> 

<TABLE valign="top" width="100%" height="2^" BORDER="0" CELLSPACING="0" 

BGCOL0R="#FFFF99"> 

<TR> 

<TD wiclth="33%" align="left"> 

<A HREF="{$prev}">Page precedente</A> 

</TD> 

<TD width="34^" align="center"> 
<A HREF="Table.html">Table</A> 
</TD> 

<TD width="33%" align="right"> 
<A HREF="{$next}">Page suivante</A> 
</TD> 
</TR> 
</TABLE> 
</xsl itempl ate> 



<!-- --> 

<xsl itemplate name="instancier-piedDePage"> 

<xsl:parain name="next"/> 
<xsl:param name="prev"/> 

<TABLE valign="top" width="100%" height="2X" BORDER="0" CELLSPACING="0" 

BGCOL0R="#FFFF99"> 

<TR> 

<TD width="33%" align="left">Ph. Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Comprendre XML et XSL</TD> 
<TD width="33%" al i gn=" ri ght"> 

<xsl:number count="pageDeTitre | pageStandard | plan" 1 evel ="any"/> 
</TD> 
</TR> 
</TABLE> 
</xsl :templ ate> 



<!-- --> 

<xsl itemplate name="instancier-plan"> 



Patterns de transformation 

Chapitre 9 



<xsl:parani nanie="f i 1 eName"/> 
<xsl:parani name="next"/> 
<xsl:parani name="prev"/> 

<xsl :document href="{$fileName}"> 
<HTML> 

<HEAD> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<BODY> 

<xsl :cal 1 -tempi ate nanie="instancier-entete"> 

<xsl :with-param name="next" sel ect="concatC $next, '.html')" /> 
<xsl iwith-param name="prev" sel ect="concat( $prev, '.html')" /> 

</xsl :call-template> 

<TABLE width="100^" height="90%" BORDER="0" CELLSPACING="10"> 
<TR val ign="top"><TD> 

<xsl lapply-templates sel ect="//pageStandarcl" mode="pl an"/> 
</TD></TR> 
</TABLE> 

<xsl :cal 1 -tempi ate name="instancier-piedDePage"/> 
</BODY> 
</HTML> 

</xsl :document> 
</xsl :templ ate> 



</xsl :stylesheet> 

Le dernier fichierobtenu, parexemple, estcelui-ci : 

XML.2.htiii1 

, <HTML> 

<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-r'> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<BODY> 

<TABLE valign="top" width="100%" height="2%" BORDER="0" CELLSPACING="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t"><A HREF="Table.html "> 
Page précédente</A></TD> 

<TD width="34%" al i gn="center"><A HREF="Table.html ">Table</A></TD> 
<TD width="33%" al ign="right"><A HREF=" .html ">Page suivante</A> 
</TD> 
</TR> 
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</TABLE> 

<TABLE width="100^" hei ght="90^" BORDER="0" CELLSPACING="10"> 
<TR val ign="top"> 
<TD> 

<H1 align="left"> XML - G&eacute:n&eacute:ralités </Hl> 
<UL TYPE="SQUARE"> 
<LI> 

XML est un langage de balisage de textes. 
</LI> 
</UL> 

<H2 align="left"> Balisage </H2> 
<UL TYPE="SQUARE"> 
<LI> 

Le principe d'un langage de balisage de textes 
existe depuis fort longtemps, 
avant ni&ecirc:nie 1 'invention de 1 'informatique. 
</LI> 

<UL TYPE="CIRCLE"> 
<LI> 

en imprimerie, le texte de répreuve est 
bal isée de 

"corrections" à effectuer (balises textuelles), 
</LI> 
<LI> 

et les relectures &agrave: voix haute, chez les 
typographes , 

se font agrémentées de balises vocales 
codifiées, avec tout un 

argot de inétier assez savoureux (trouvé 
dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques 
André , in 

Cahier GUTemberg No 31, D&eacute:cembre 1998) : 
</LI> 

<UL TYPE="DISC"> 
<LI> 

le métro Cinventé par 

Bienven&uuml ;e ! . . . ) 
</LI> 
<LI> 

le métro <B>ouvre</B> inventé 
par Bienven&uuml ;e <B>cap couilles clame suce ferme 
</B> 

</LI> 
</UL> 
</UL> 
</UL> 

<UL TYPE="SQUARE"> 
<LI> 

Avec 1 'invention de 1 'informatique, les techniques de 
bal isages 
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se sont appl iquées à la commande des 
Linotypes par bandes 

perforées, où le texte à composer 
était parsemé de commandes 
destin&eacuteies à la manoeuvre de la Lynotype 
elle m&ecirc:me (passer en gras, 
changer de corps, faire un retrait, etc.). 

</LI> 
</UL> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100%" height="2^" BORDER="0" 
CELLSPACING="0" BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33^" align="left">Ph. Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Comprendre XML et XSL</TD> 
<TD width="33%" al ign="right">4</TD> 
</TR> 
</TABLE> 
</BODY> 
</HTML> 

II peut etre aussi interessant de voir le fichier Table. htmi, pour le comparer aux regies 
qui I'ontcree. 

Table .html 

<HTML> 
<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<BODY> 

<TABLE valign="top" width="100%" height="2^" BORDER="0" CELLSPACING="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t"><A HREF="XML.l.html "> 
Page pr&eacute:cédente</A></TD> 

<TD width="34%" al ign="center"><A HREF="Table.html ">Table</A> 
</TD> 

<TD width="33%" al ign="right"><A HREF="XML.2.html "> 
Page suivante</A></TD> 
</TR> 
</TABLE> 

<TABLE width="100^" height="90%" BORDER="0" CELLSPACING="10"> 
<TR val ign="top"> 
<TD> 

<H1 align="left"><A HREF="XML.l.html ">Déroulenient du 
Cours</A></Hl> 
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<H1 align="left"><A HREF="XML.2.html "> 
XML - G&eacute:n&eacute:ralit&eacute:s </A></Hl> 
<H2 align="left"><A HREF="XML.2.html "> Balisage </A></H2> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100^" height="2%" BORDER="0" CELLSPACING="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33%" al i gn="l ef t">Ph . Drix - Objectiva</TD> 
<TD width="34%" al i gn="center">Coniprendre XML et XSL</TD> 
<TD width="33%" align="right">3</TD> 
</TR> 
</TABLE> 
</BODY> 
</HTML> 
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Transformation XML - RTF 



Je presente ici une realisation reel I e, celle qui a permis la production technique de ce 
livre. J 'avals commence, auparavant, la redaction d'un support de cours de formation 
XML etXSLT pour ma societe. Ce support etaitlui-memeau formatXML, carl'un des 
objectifsetait de pouvoir realiser cette source sous differents formats, notamment un for- 
mat imprimablede haute qualite, et un format video-projetable. Le format imprimablede 
haute qualite etait produit par une transformation XSLT donnant un source Latex (lui- 
meme a compiler pour produire un fichier imprimable), et le format video-projetable par 
une autre transformation XSLT donnant du HTM L. 



Note 

A I'epoque, la solution passant par du XSL-FO donnant du PDF a I'arrivee n'etait pas envisageable, car il n'y 
avait pas encore de processeurs FO disponibles, alors que les compilateurs Latex existent depuis de tres 
nombreuses annees. 

Puis I'idee m'est venue que ce document pourrait faire I'objet d'un livre, et j'ai com- 
mence a reprendre la redaction en consequence. Mais j'ai conserve le format source 
XML, afin de rester independant des technologies proprietaires, quelles qu'elles soient. 
Mon idee etait de peaufiner la transformation XSLT produisant du Latex, car 11 reste 
effectivement tres difficile de surpasser le resultat d'une compilation Latex, en ce qui 
concerne I 'aspect prof essionnel etesthetique del 'impression finale. 

Mais, apres avoir finalement signe un contrat d'edition avec la societe Eyrolles, il a 
fallu s'adapter a une chalnede production partant d'un fichier source au format M icro- 
soft Word : I'auteur est en effet cense fournir au final un document Word, stylise sui- 
vant unefeuille de style fournie par Eyrolles. Ce document Word est le point de depart 
de la chainede production : il est sauvegarde au formatRTF (le format texte capable de 
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sauvegarder sans perte de styles le contenu d'un document Word), puis repris sous 
FrameM aker avec un certain nombrede macros permettant d'automatiser au maximum 
la mise en page. 

Partantd'un documentXM L, il n'y avait que deux solutions pourfournir un fichierWord 
(ou RTF, cequi revientau meme) : 

• soit reprendrea la main la source X M L, I'injecter petit a petit par copier-coller dans un 
document Word, et appliquer au fur et a mesure les styles adequats ; 

• soit tenter d'obtenir automatiquement un fichier RTF correctement stylise a parti r de la 
sourceXM L. 

La premiere solution demande un travail long, fastidieux, et sans interet. 

La deuxieme solution consisteaecrireunefeuilledestyleXSLT qui produisedu RTF a 
partir d'un document XM L exprimant la structure et la semantique d'un texte ; mais la 
difficulte essentielle, en tout cas pour moi, est la meconnaissance du format RTF lui- 
meme. 

Etant donne les delais impartis, il m'etait impossible de me mettre a apprendre RTF ; je 
me suis alors rabattu sur une solution de fortune, mais qui s'est revelee finalement tres 
fiable et assez simple a mettre en oeuvre. J 'ai redige sous Word un texte d'une page ou 
deux, comportanttous les styles possiblesfournis par Eyrolles, texte que j'ai sauvegarde 
au format RTF. II m'a ensuite suffitde reperer les sequences RTF propres a chaquestyle 
Word, et deles injecter dans chacunedes regies XSLT correspondantes. J 'ai ainsi obtenu 
a peu de frais un generateur RTF, non universel, il est vrai, puisqu'entierement lie a la 
DTD adoptee pour le document X M L, mais capable de transformer toute instance XML 
decetteDTD en un fichier RTF ayant I 'aspect attendu lorsqu'on I'ouvre sous Word. 

C'est cette solution que j'ai done retenue pour la production finale du document RTF a 
fournir a I'editeur. 



Structure du document source XML 

La structure du document XM L (ou DTD) a ete determinee avant d'avoir a resoudre le 
probleme de la transformation en RTF. Cette DTD a largementete infiuencee par deux 
idees directrices : d'une part eviter les structures fortement hierarchiques, et d'autre part 
faciliter la transformation XSLT produisant du HTM L et du Latex, puisque c'etait au 
depart les deux langages-cibles envisages. 

La premiere contrainte etait motivee par la volonte de ne pas etre tributaire d'un editeur 
XML dedie, mais au contrairedepouvoir utiliser un editeur detextes general iste, comme 
BBEdit sous M acOS, UltraEdit sous Windows, ou XEmacs sous Unix ou Windows. Or 
une DTD comme eel le de DocBook, par exemple (voir Exemple, page 385), estextreme- 
ment penible a utiliser sans editeur XML specialise, a cause de la grande distance qui 
peut separer une balise ouvrante de la balise fermante correspondante, et du degre el eve 
d'imbrication des elements les uns dans les autres. Cela rend les modifications de 
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Structure du document (par exemplepermuter deux sections, passer une section de niveau 
2 en niveau 3, ou I'inverse, etc.) inextricables a realiser sans un outil capable de manipuler 
global ement un element et toute sa descendance. 

La deuxieme contrainte demande a ce que grosso-modo, chaque balise X M L utilisee ait 
son equivalent en Latex et en HTML, c'est-a-dire qu'il n'y ait pas de fosse structure! 
entre le document source XM L et les documents resultats en HTM L ou Latex. En fait il 
se trouve que Latex et HTM L sont deux langages de ballses qui peuvent etre assez voi- 
sins structurellement, dans la mesure ou le principal, c'est le texte au kilometre (avec 
eventuellement un regroupement de phrases par paragraphe), parseme de ballses indi- 
quant un titre de section niveau 1, 2, 3, etc. 

Or, 11 se trouve que RTF estlui aussi un langagede ballses assez peu tourne vers I 'imbri- 
cation des structures mises en oeuvre. 

Nous avons done conserve a peu pres la DTD d'origine, en I'augmentantd'elements sup- 
plementaires provenant de la description des styles Word fournis par les editions Eyrol- 
les. Cette DTD, conformement aux deux contraintes indiquees ci-dessus, evite au 
maximum toute imbrication structurelle d'elements de type « bloc de texte » ; les seuls 
blocs structurants sont les paragraphes, les remarques, les listings de diverses sortes, les 
figures, les listes et les tableaux, mais ces elements sont uniquement juxtaposables (pas 
d'imbrication possible). 

Bien sur, des elements peuvent apparaitre dans un paragraphe, par exemple, (pour mar- 
quer un fragment de code dans du texte courant, ou pour indiquer des mots importants, 
ou des renvois vers d'autres parties du document, etc.), mais ces elements ne sont pas des 
blocs en ce sens qu'ils n'ont aucun enfant direct. 

Par exemple, le texte XM L aux environs de la section Instruction xsl:import, page 381 
est balise ainsi : 

<!-- 

--> 

<titre2 i d=" include. tit re. 10. Decoupe" i ndexWords="l. 2 ">Inst ruction xsl : import</titre2> 



<!-- 
--> 

<titre3 id="iinportSyntaxe. titre. 11. Decoupe">Syntaxe</titre3> 



<ti treCode>xsl : import</titreCode> 

<1 istingAvecTi treX! [CDATA[<xsl : import 

href=" ..." 
/>]]></! istingAvecTitre> 
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<paragraphe>L'attribut href <tresImportant> ne doit pas </tresImportant> etre un 

descripteur de valeur differee. 
</paragraphe> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl:import 
</codeDansTexte> doit apparattre comme instruction de premier niveau, et de plus 
doit apparaitre avant toute autre instruction. 

</paragraphe> 



<!-- 

★it************************************************************************ 

--> 

<titre3 id="iniportSeinantique.titre.l2.Decoupe"> Semantique</titre3> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl:import 
</codeDansTexte> permet d'incorporer au fichier source XSLT courant les 
instructions XSLT d'un autre fichier source XSLT dont I'URI est fourni par 
I'attribut <codeDansTexte avant=" " >href</codeDansTexte>. La difference avec 
<codeDansTexte avant=" " apres=" ">xsl :incl ude</codeDansTexte> tient a ce que les 
conflits. en cas de definitions multiples d'une meme instruction XSLT, ne sont pas 
necessai rement des cas d'erreurs, et peuvent etre resolus grace a des regies 
specifiques. 

</paragraphe> 



<!-- 

<titre4 id="iniportSemantiqueproc.titre.l3.Decoupe"> Processus mis en (Euvre</titre4> 

<index indexWords="l,4,5">Instanciation de 1 'instruction xsl :import</index> 

<index indexWords="l,3,7,8">Detection de conflits dus a 1 'instruction xsl:import 
</index> 

<index indexWords="l,4,9">Calcul de la preseance des feuilles importees par 
xsl :import</index> 

<paragraphe>Le processus d'incorporation des instructions XSLT provenant d'une 
feuille de style importee est le meme que dans le cas d'une inclusion (voir 
<renvoi\/ersTitre idRef="incl udeSemantiqueproc.titre.S.Decoupe" avant=" " />). Ce 
qui change, c'est 1 'interpretation du resultat une fois I'incorporation terminee. 
On peut exprimer cela assez facilement sur un dessin (voir <renvoiVersFigure 
idRef="include-import.fig.l.Decoupe" avant=" " />, oti <italiques> A</italiques>, 
<italiques> B</italiques>, <italiques> C</italiques>, et <italiques> D 
</italiques> representent des instructions XSLT quelconques) : dans le cas d'une 
inclusion, la double presence de 1 'instruction <italiques> B </italiques> pose (en 
general) probleme; mais dans le cas d'une importation, elle ne pose pas probleme. 

</paragraphe> 
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<figure id="incl ude-import.fig.l.Decoupe" dir=" images/ I nstructionsDecoupage 
file=" include- import.eps" legende='Coniparaison inclusion-importation'/> 



<remarque titre="Note">La <renvoiVersFigure idRef="include-iniport.fig.l.Decoupe" 
avant=" " apres=" " /> suggere un conflit potentiel entre 1 'element <italiques> B 
</italiques> de la feuille principale et 1 'element <italiques> B </italiques> de 
la feuille importee. Neanmoins, il faut garden a 1 'esprit qu'une stricte identite 
d'element n'est pas necessaire a 1 'apparition d'un conflit : deux regies de 
transformation de motifs differents peuvent tres bien engendrer un conflit sur un 
certain nieud, si les deux motifs concordent simul tanement avec ce mud. La figure 
est ici un support visuel qui permet de mettre en evidence les endroits ou I'on 
discute d'un conflit, mais elle ne doit pas faire croire que les conflits ne 
peuvent pas surgir ailleurs. 

</remarque> 



M algre un aspect un peu rebarbatif a la lecture, ce genre de texte est tres rapide a taper 
sous un editeur detextes comme UltraEdit, XEmacs ou BBEdit, parce que chaque bali- 
sage peut etre realise par appel d'une macro adequate, apres avoir selectionne le ou les 
mots a baliser. La transformation XSLT d'un chapitre est tres rapide (5 secondes pour 
obtenir 100 pages de document final Word avec Saxon, sur un PC portable Pill), ce qui 
permet de controler tres souvent (sous Word) le rendu du resultat obtenu. 

Description de la DTD utilisee 

La DTD reprend les idees exprimees plus haut, en evitant au maximum les possibilites 
d'imbrication. Certaines limitations proviennent de la feuille de style Word fournie par 
les editions Eyrolles ; par exemple, il n'y a que deux niveaux de listes a puces, probable- 
ment parcequ'il neserait pas raisonnable, d'un pointdevueredactionnel, d'aller au del a. 

xml -rtf .dtd 

<?xml version='1.0' encoding='UTF-16' ?> 



<!-- [ 



DTD pour la traduction RTF de documents XML 

Chaque <!ELEMENT ... > correspond a un style de feuille de style RTF. 



--> 



<!-- ================================================== 

<!-- Entites definissant des raccourcis d'ecriture dans 



> 



les definitions d'elements ou d'attributs --> 
<!-- ============================================= 



> 



<!ENTITY % fragmentDeTexte "#PCDATA | subtil | italiques | titreOeuvre | 

treslmportant | codeDansTexte | 
codeRTFDansTexte | 
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renvoiVersTableau | renvoiVersFigure | 
renvoiVersTitre | espace | 
br I refBiblio 



> 



<!ENTITY % fragmentDeTexteAvecNoteBP "#PCDATA | subtil | italiques | 



<!ENTITY % elementDeListing "#PCDATA | pseudocode | codeFaux 

" > 

<!-- definition des elements associes --> 



<! ELEMENT subtil (#PCDATA) > 
<! ELEMENT italiques (#PCDATA) > 

<! ELEMENT titreOeuvre (#PCDATA) > 

<!ELEMENT treslmportant (#PCDATA) > 

<!ELEMENT codeDansTexte (#PCDATA)> 

<!ATTLIST codeDansTexte avant CDATA #IMPLIED > 

<!ATTLIST codeDansTexte apres CDATA #IMPLIED > 

<! ELEMENT codeRTFDansTexte (#PCDATA)> 

<!ATTLIST codeRTFDansTexte avant CDATA #IMPLIED > 

<!ATTLIST codeRTFDansTexte apres CDATA #IMPLIED > 

<! ELEMENT pseudocode (#PCDATA)> 

<!ELEMENT codeFaux (#PCDATA)> 

<!ELEMENT renvoiVersFigure (#PCDATA)> 

<!ATTLIST renvoiVersFigure idRef IDREF #REQUIRED > 

<!ATTLIST renvoiVersFigure avant CDATA #IMPLIED > 

<!ATTLIST renvoiVersFigure apres CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre postit CDATA #IMPLIED > 

<!ELEMENT renvoiVersTitre (#PCDATA)> 

<!ATTLIST renvoiVersTitre idRef IDREF #REQUIRED > 

<!ATTLIST renvoiVersTitre avant CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre apres CDATA #IMPLIED > 

<!ATTLIST renvoiVersTitre postit CDATA #IMPLIED > 



titreOeuvre | treslmportant | 
codeDansTexte | codeRTFDansTexte 
renvoiVersTableau | 
renvoiVersFigure | 
renvoiVersTitre | espace | 
br I noteBP | refBiblio 



> 



<!-- 



--> 
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<!ELEMENT renvoi VersTabl eau C#PCDATA)> 
<!ATTLIST renvoiVersTableau idRef IDREF ^REQUIRED > 
<!ATTLIST renvoiVersTableau avant CDATA #IMPLIED > 
<!ATTLIST renvoiVersTableau apres CDATA ^IMPLIED > 
<!ATTLIST renvoiVersTitre postit CDATA #IMPLIED > 



<!ELEMENT refBiblio (#PCDATA)> 

<!ATTLIST refBiblio idRef IDREF #REQUIRED > 

<!ELEMENT index (#PCDATA)> 

<!ATTLIST index indexWords CDATA #IMPLIED > 

<!ELEMENT espace EMPTY > 

<!ELEMENT br EMPTY > 

<!ELEMENT aerati onVerti cal e EMPTY > 



<! ENTITY % blocDeTexte "parti e | titreChapitre | titreAnnexe 
titre2 | titreS | titre4 | titreB | 
paragraphe | tableau | remarque | 
figure | listing | listingRTF | 
1 istingPseudoCode | 
codeUneLigne | aerationVerticale | 
fichier | liste | listeANumero | 
1 igneCodeAvecCommentai re | 
comirentai reLigneDeCode | index | 
titreCode | listingAvecTitre | 
sousTitreCommentai re | 
exeirplePourSousTi treDeCoinmentai re 
" > 

<!ENTITY % titre.attributs "id ID #REQUIRED 

numero CDATA #IMPLIED 
indexWords CDATA #IMPLIED 
"> 

<!-- definition des elements associes --> 
<i > 

<!ELEMENT partie (Zf ragmentDeTexte; )* > 
<!ATTLIST partie ^titre.attributs; > 

<!ELEMENT titreChapitre (^f ragmentDeTexte; )* > 
<!ATTLIST titreChapitre ^titre.attributs; > 



<!ELEMENT titreAnnexe (^fragmentDeTexte; )* > 
<!ATTLIST titreAnnexe ^titre.attributs; > 
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<!ELEMENT titreZ (^fragmentDeTexteAvecNoteBP; )* > 
<!ATTLIST titreZ Ztitre.attributs; > 



<!ELEMENT titreS (^fragmentDeTexteAvecNoteBP; )* > 

<!ATTLIST titreS ^titre.attributs; > 

<! ELEMENT titre4 (^fragmentDeTexteAvecNoteBP; )* > 

<!ATTLIST titre4 %titre.attributs; > 

<!ELEMENT titreS (^fragmentDeTexteAvecNoteBP; )* > 

<!ATTLIST titreS Ztitre.attributs; > 

<! ELEMENT paragraphe (^fragmentDeTexteAvecNoteBP; | index)* > 

<! ELEMENT noteBP (^fragmentDeTexte; )* > 



<! ELEMENT remarque (^f ragmentDeTexteAvecNoteBP; | index)* > 
<!ATTLIST remarque id ID #REQUIRED 

titre CDATA #REQUIRED 

> 



<!ELEMENT figure EMPTY 
<!ATTLIST figure 



> 

id 
di r 
file 
1 egende 



ID #REQUIRED 
CDATA #IMPLIED 
CDATA #REQUIRED 
CDATA #REQUIRED 



<! ELEMENT listing (%elementDeLi sting;)* > 

<!ELEMENT listingRTF (^elementDeListing; )* > 

<!ELEMENT 1 istingAvecTitre (%elementDeListing;)* > 

<!ELEMENT 1 i sti ngPseudoCode (%elementDeListing: )* > 

<! ELEMENT codeUneLigne (#PCDATA) > 

<! ELEMENT fichier EMPTY > 

<!ATTLIST fichier nom CDATA #REQUIRED > 



<! ELEMENT 1 i gneCodeAvecCommentai re (#PCDATA) > 

<!ELEMENT commentai reLi gneDeCode (^f ragmentDeTexteAvecNoteBP; )* > 



<! ELEMENT titreCode (#PCDATA) > 



<! ELEMENT sousTitreCommentai re (#PCDATA) > 

<!ELEMENT exempl ePourSousTi treDeCommentai re (#PCDATA) > 

<! ELEMENT listeANumero ( item | listeZ )+ > 
<! ELEMENT liste ( item | liste2 )+ > 
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<! ELEMENT liste2 ( item )+ > 

<!ELEMENT item (%f ragmentDeTexteAvecNoteBP ; )* > 

<!ATTLIST item no CDATA #IMPLIED > 



<!ELEMENT tableau 
<!ATTLIST tableau 



( legende?, titresColonnes, 
id ID #IMPLIED > 



lignes+ ) > 



<!ELEMENT tabl eauSansTi tresCol onnes ( legende?, 
<!ATTLIST tableauSansTitresColonnes id ID 



<!ELEMENT titresColonnes 
<! ELEMENT lignes 



ignes+ ) > 
#IMPLIED > 



)* > 



( cellule I nouvelleCellule 
( cellule I nouvelleCellule | 
nouvelleLigne )* > 
<!ELEMENT legende (^f ragmentDeTexte; )* > 
<!ELEMENT cellule (^f ragmentDeTexteAvecNoteBP; | celbr)* 
<!ELEMENT nouvelleCellule EMPTY > 
<!ELEMENT nouvelleLigne EMPTY > 
<!ELEMENT celbr EMPTY > 



<i-- ================================================================== --> 

<!-- ========================= --> 

<!-- Qu'est-ce qu'un livre ? --> 
<i-- ========================= --> 

<!ELEMENT livre ( partie | chapitre )* > 
<!ELEMENT chapitre (^blocDeTexte; )* > 

<!-- ================== --> 

<!-- fin --> 

<!-- ] --> 



Transformation XSLT 

1 1 y a en gros trois sortes de modeles de transformation a mettre au point : 

• Ceux qui sont specifiquementdedies a la traduction RTF d'un element XIV| L refletant 
un style Word ; par exemple, la traduction en RTF de I'element <codeDansTexte>. 

• Ceux qui sont lies a la presence de caracteres speciaux en RTF, qu'il s'agit dedetecter 
et d'envelopper de telle sorte qu'ils redeviennent non significatifs ; par exemple, le 
backslash "\" ou les accolades ■■{}". 
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• Ceux qui realisent un traitement independant du langage cible, comme par exemple 
certains traitements purement algoritlimiques intervenant dans la creation des entrees 
d'index. 

L'ensemble de ces regies et modeies nommes n'est pas tout a fait compiet, car ii ne donne 
que la generation du corps de document RTF proprement dit ; celle du prologue RTF est 
assuree par une regie unique et specifique. 

Prologue 

Un document RTF est constitue d'un prologue et d'un corps de document ; lorsqu'il est 
genere par Word, le prologue est un texteassez volumineux de 35000 caracteres environ ; 
c'est la regie X SLT de traitement de la racine du document X M L qui est cliargee de generer 
ce prologue : 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xml ns:saxon="http: //i cl .com/saxon" 

extension -el ement-pref ixes="saxon" 

version = "1.0"> 



<xsl :strip-space el einents="*"/> 

<xsl:output method^'text' encoding='IS0-8859-r /> 

<xsl :templ ate match='/'> 
<xsl :text> 

<xsl :text>{\rtfl\ansi\ansicpgl252\ucl \deffO\def 1 angl036\defl angfel036 

{\fonttbl {\f0\froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New 
Roman ;}{\fl\fswiss\fcharset0\fprq2{\*\panose 020b0604020202020204)Ari al : } 
{\f2\fmodern\fcharset0\fprql{\*\panose 02070309020205020404}Courier New:}{\f3\ 
froman\fcharset2\fprq2{\*\panose 05050102010706020507} Symbol ; } (\f4\f roman\ 
fcharset0\fprq2{\*\panose 02020603050405020304)Times ; } 
{\fl4\fnil\fcharset2\fprq2{\*\panose 05000000000000000000}Wingdings:){\f28\fswiss\ 
fcharset0\fprq2{\*\panose 020b0506020202030204)Ari al Narrow;} 

. . . etc . . . 

{\f1eld{\*\fldinst {\b SECTIONPAGES W* MERGEFORMAT }}{\fldrslt { \b\l angl024\ 
1 angfel024\noproof 5} } } {\par } } {\*\pnsecl vl I\pnucrm\pnstartl\pn1ndent720\pnhang 
{\pntxta . } ) {\*\pnsecl vl 2\pnucl tr\pnstartl\pnindent720\pnhang{\pntxta . } } {\*\ 
pnsecl vl3\pndec\pnstartl\pnindent720\pnhang{\pntxta . } } (\*\pnsecl vl4\pnlcltr\ 
pnstartl\pnindent720\pnhang{\pntxta ) } } 

{\*\pnsecl vl 5\pndec\pnstartl\pnindent720\pnhang{\pntxtb ( } {\pntxta ) ) } {\*\pnsecl vl 6\ 
pnl cl tr\pnstartl\pnindent720\pnhang{\pntxtb ( } {\pntxta ) } } {\*\pnsecl vl 7\pnl crm\ 
pnstartl\pnindent720\pnhang{\pntxtb ( } {\pntxta ) } } {\*\pnsecl vl8\pnl cl tr\pnstartl\ 
pnindent720\pnhang{\pntxtb ( }{\pntxta ) } } {\*\pnsecl vl 9\pnl crm\pnstartl\ 
pnindent720\pnhang{\pntxtb (){\pntxta )}} 

</xsl :text> 
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</xsl :text> 

<xsl :cal 1 -tempi ate naine="instancier-sautDeLigne"/> 

<xsl :apply-teinplates/> 

) 



</xsl itempl ate> 



Note 

D'une maniere generale, le code RTF genere par Word, et repris tel quel dans les regies de transformation XSLT 
mises au point, est d'une grande verbosite (ou complexite ?), si on le compare a des fichiers RTF obtenus par 
d'autres moyens. Le butetantde pouvoirouvrirle document obtenu sous Word, il ne m'a pas semble utile de 
chercher a simplifier quoi que ce soit. 



Regies pour la transcription RTF d'un style 

Les regies les plus simples sont celles associees a des elements qui ne sont ni la cible de 
renvois, ni associes a des entrees d'index. Par exemple : 

<!-- 

==== subtil ====== 

--> 

<xsl : tempi ate match='subtil '> 

<xsl :text>{\cs59\i </xsl:text> 

<xsl lapply-templates inode='noTrim'/> 

<xsl :text>)</xsl :text> 
</xsl :templ ate> 

<!-- 

==== italiques ====== 

--> 

<xsl : tempi ate match='italiques'> 

<xsl :text>{\i </xsl :text> 

<xsl :apply-teinplates mode='noTrim'/> 

<xsl :text>)</xsl :text> 
</xsl itempl ate> 

<!-- 

==== pseudocode ====== 

--> 

<xsl :template match='pseudoCode' mode='listing'> 

<xsl :text>{\cs78\i </xsl:text> 

<xsl :apply-templates mode='listing'/> 

<xsl :text>)</xsl :text> 
</xsl itempl ate> 



<!-- 
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==== titreOeuvre ====== 

--> 

<xsl itemplate match='titreOeuvre'> 

<xsl :text>{\cs62\i </xsl:text> 

<xsl lapply-templates niode='noTriin'/> 

<xsl :text>}</xsl :text> 
</xsl itempl ate> 

<!-- 

==== tres important === 

--> 

<xsl itemplate match='tresImportant'> 

<xsl :text>{\cs60\b </xsl:text> 

<xsl :apply-templates mode='noTrim'/> 

<xsl :text>}</xsl :text> 
</xsl itempl ate> 

Les regies pour la transformation d'elements qui peuventetre la cible de renvois sont un 
peu plus compliquees, a cause des instructions RTF \bkmkstart et \bkmkend a generer. 

<!-- 

==== remarque ========================================= 

--> 

<xsl itempl ate match=' remarque'> 
<xsl itext> 

\pard\pl ain \s40\qj \1 i 1418\ri0\sbl60\widctlpar\txl418\aspal pha\aspnum\f aauto\ 
adjustright\rin0\linl418\itap0 \b\f28\fsl8\lang3084\langfel036\cgrid\langnp3084\ 
langfenpl036 { 
{\*\bkmkstart </xsl itext> 

<xsl ival ue-of select="translate( @id, '')"/> 
<xsl itext>}</xsl itext> 

<xsl icall-template name="instancier-sautDeLigne"/> 
<xsl ival ue-of select="@titre"/> 
<xsl ical 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl itext>{\*\bkmkend </xsl itext> 
<xsl ival ue-of select="translate( @id, '')"/> 
<xsl itext>} 
\par ) 

\pard\plain \s39\qj \lil418\ri0\sb40\widctlpar 

\txl418\aspalpha\aspnum\faauto\adjustright\rin0\l inl418\itap0 \f sl8\l ang3084\ 
Iangfel036\cgrid\langnp3084\langfenpl036{</xsl itext> 
<xsl iapply-templates/> 

<xsl ical 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl itext>\par )</xslitext> 

<xsl ical 1 -tempi ate name="instancier-sautDeLigne"/> 
</xsl itempl ate> 
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L'appel a la fonction translate, ci-dessus, a lieu dans toutes les regies definissant des 
signets (bool<mark) RTF, car RTF n'acceptepas certains caracteres dans les signets, alors 
qu'ils sont autorises en XM L pour former un identifiant. Par securite, les occurrences 
eventuelles de I'un des 3 caracteres ' .-„' pouvant intervenir dans un identifiant XM L 
sont supprimeesdu signet RTF. 

La categorie suivante est celle des regies associees a des elements qui peuvent etre la 
cible de renvois, et contenir des directives d' entrees d' index : 

<!-- 

==== titre niveau 2 ========================================= 

--> 

<xsl :template match='titre2'> 
<xsl :text> 

\pard\pl ain \s2\ql \1 i0\ri0\sb500\keep\keepn\widctl par\aspal pha\aspnum\faauto\ 
outlineleven\adjustright\rinO\linO\itapO \b\f l\fs28\l angl024\l angfel024\cgrid\ 
noproof \1 angnpl036\l angfenpl036 

{ 

{\*\bkiiikstart </xsl :text> 

<xsl :val ue-of sel ect="transl ate( @id, '')"/> 
<xsl :text>)</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :apply-templates/> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :text>{\*\bkmkend </xsl :text> 
<xsl :val ue-of sel ect="transl ate( @id, '')"/> 
<xsl :text>}</xsl :text> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl:if test="@indexWords"> 

<xsl :call-template name="instancier-XEntries"> 

<xsl :with-parani nanie="l istOfNumbers" select="@indexWords"/> 
<xsl :wi th-param nanie="stringToSpl i t" sel ect=" normal ize-space( . ) "/> 
</xsl : cal 1 -tempi ate> 
</xsl :if> 

<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :text>\par }</xsl:text> 

<xsl :cal 1 -tempi ate name="1nstancier-sautDeLigne"/> 
</xsl itempl ate> 

Le modele nomme instancier-xEntries permet de generer les entrees d'index. Par 
exemple, avec le titre suivant : 

<!-- 

*************************************************************************** 
--> 

<titre4 id="importSemantiqueinter. titre. 14. Decoupe" indexWords="l,4,5"> Interet 
de I'instruction xsl : import</titre4> 
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on aura les entrees d'index suivantes : 

I {\xe \v{Interet de 1 'instruction xsl nmport)) 
I {\xe \v{instruction xsliimport (Interet de 1')}) 
I {\xe \v{xsl : import (Interet de 1 'instruction )}) 

En effet, I'attribut indexwords donne les numeros de mots du titre qui doivent setrouver 
places en premier dans chaque entree d'index. Seuls les caracteres apostrophe et espace 
sont separateurs de mots, xsi nmport est done considere comme un seul mot. 

Regies pour rendre inoffensifs certains caracteres en RTF 

Ces regies concernentsurtout la fagon de rendre un texte non balise, pouvantcontenir des 
caracteres anodinsen XM L, mais significatifs en RTF. 



<!- 



=== text 
-> 



<xsl itempl ate match='text()'> 

<xsl :cal 1 -tempi ate name^'i nstancier-texteAvec -escape- accol ades"> 
<xsl :with-param name=''texte" sel ect="normal ize-space( . ) " /> 

</xsl :call-template> 
</xsl itempl ate> 

<!--> 



<!--> 



<xsl itempl ate match='text( ) ' mode='noTrim'> 

<xsl ical 1 -tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl iwith-param name=''texte" select=''." /> 

</xsl icall-template> 
</xsl itempl ate> 



<!--> 
<!--> 



<xsl itempl ate match='text( ) ' mode='listing'> 

<xsl ical 1 -tempi ate name^'instancier-texteAvec-RTFpar-et-escape-accol ades"> 
<xsl iwith-param name="texte" select="translate( .,'«»', '<>' )" /> 

</xsl I cal 1 -tempi ate> 
</xsl itempl ate> 



<!--> 



<!--> 
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<xsl : tempi ate match^'textC ) ' mode='listingRTF'> 
<xsl :cal 1 -tempi ate 

name="instancier-texteAvec-RTFpar-et-escape-accol ades-et-backsl ash"> 

<xsl :with-param name="texte" select="translate( .,'«»', '<>' )" /> 
</xsl :call-template> 
</xsl :templ ate> 



<!--> 



<!--> 

<xsl : tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl:param name="texte" /> 

<xsl :variable name="codeSource2"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades-gauches"> 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl :call-template> 
</xsl :variable> 

<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades-droites"> 
<xsl :with-param name="codeSource" select="$codeSource2" /> 

</xsl :call-template> 
</xsl :variable> 

<xsl :copy-of sel ect="$codeSoLirce3"/> 
</xsl itempl ate> 



<!--> 



<!--> 

<xsl : tempi ate name=' instancier-texteAvec-RTFpar-et-escape-accol ades ' > 
<xsl:param name="texte" /> 

<xsl :variable name="codeSourcel"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-RTFpar"> 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl :call-template> 
</xsl :variable> 



<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol ades"> 
<xsl :with-param name="texte" select="$codeSourcel" /> 

</xsl :call-template> 
</xsl :variable> 
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<xsl :copy-of sel ect="$cocleSource3"/> 
</xsl itempl ate> 



<!--> 



<!--> 
<xsl :templ ate 

nante=' instancier-texteAvec-RTFpar-et-escape-accol ades-et-backsl ash' > 
<xsl:param nanie="texte" /> 

<xsl ivariable naine="codeSource3"> 

<xsl :cal 1 - tempi ate name=''instancier-texteAvec-escape-backsl ash''> 
<xsl :with-param name="cocleSource" sel ect="$texte" /> 

</xsl :call-template> 
</xsl :variable> 

<xsl ivariable naine="codeSourcel"> 
<xsl :call-template 

name^-instancier-texteAvec-RTPpar-et-escape-accol ades"> 

<xsl :with-param name="texte" select="$codeSource3" /> 
</xsl :call -teniplate> 
</xsl :variable> 

<xsl :copy-of select="$codeSourcer7> 
</xsl itempl ate> 



<!--> 



<!--> 



<xsl itemplate name="instancier-texteAvec-RTFpar''> 
<xsl:param name^'codeSource" /> 
<xsl :choose> 

<xsl iwhen test="contains( ScodeSource, '&#xa:' )"> 

<xsl : val ue-of select="substring-before( ScodeSource, '&§xa;' )" /> 
<xsl :cal 1 -tempi ate name="instancier-sautDeLigne"/> 
<xsl :text>\par </xsl:text> 

<xsl :cal 1 - tempi ate name=''instancier-texteAvec-RTFpar"> 
<xsl iwith-param name=''codeSource" 

select="substring-after($codeSource, '&#xa: ' )"/> 

</xsl :call-template> 
</xsl :when> 



<xsl :otherwise> 
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<xsl :val ue-of sel ect="$codeSource" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 

<!--> 

<!--> 

<xsl : tempi ate name="instancier-texteAvec-escape-backsl ash"> 
<xsl:parain naine="codeSource" /> 
<xsl :choose> 

<xsl:when test="contains( $codeSource, '\' )"> 

<xsl :val ue-of sel ect="substring-before( $codeSource, '\' )" /> 
<xsl :text>\\</xsl :text> 

<xsl :cal 1 - tempi ate naine="instancier-texteAvec-escape-backsl ash"> 
<xsl iwith-param name="codeSource" 

select="substring-after($codeSource, '\' )" /> 

</xsl :call-teinplate> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of sel ect="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 

<!--> 

<!--> 

<xsl itempl ate name="instancier-texteAvec-escape-accol ades-gauches"> 
<xsl:param naine="codeSource" /> 
<xsl :choose> 

<xsl iwhen test="contains( $codeSource, '{' )"> 

<xsl :val ue-of sel ect="substring-before( $codeSource, '{' )" /> 
<xsl :text>\{</xsl :text> 
<xsl :call-template 

name="instancier-texteAvec-escape-accol ades-gauches"> 
<xsl :with-param name="codeSource" 

select="substring-after($codeSource, '{' )" /> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of sel ect="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :templ ate> 
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<!--> 



<!--> 

<xsl : tempi ate naine="instancier-texteAvec -escape- accol ades-droi tes"> 
<xsl:parain nanie="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '}' )"> 

<xsl :value-of select="substring-before( $codeSource, ')' )" /> 
<xsl :text>\)</xsl :text> 
<xsl :call-template 

name="instancier-texteAvec-escape-accol ades-droi tes"> 
<xsl :with-param name="codeSource" 

sel ect="substring-after($codeSource, ')')"/> 

</xsl :call-template> 
</xsl :when> 

<xsl :otherwise> 

<xsl :value-of select="$codeSource"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 

<!--> 



<!--> 

<xsl :template naine="instancier-sautDeLigne"> 

<xsl :text> 
</xsl :text> 
' </xsl :templ ate> 

On notera que certains modeles nommes sont recursifs (instancier-texteAvec-escape- 
accoi ades-droi tes par exemple), mais tous sont sur le modele d'une recursion terminale. 



Entrees d'index 

La generation des entrees d'index est la partie la plus complexe de la transformation, 
mais la difficulte est algorithmique, et independante du choix du langage cible RTF. II 
s'agit, a partir d'une chaine de caracteres et d'une liste de numeros de mots, de produire 
diverses permutations de mots dans la chaine de caracteres initiale. 

Par exemple, avec la chaine « detection de conflits dus a I'instruction xsl:import» et la 
liste de numeros de mots « 1,3,7,8 », il faut produire les permutations (les separateurs de 
mots sont I 'apostrophe eti'espace ) : 

• detection de conflits dus a I'instruction xsl:import 

• conflits dus a I'instruction xshimport (Detection de) 
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• instruction xsl:import (Detection deconflits dus a I') 

• xsl:import (Detection deconflits dus a instruction) 

L'ensemble de ces entrees est produit par le modele nomme instancier-XEntries, qui 
lui-memeappellelemodeleinstancier-xEntry nfois, unefois par numero demot. Clia- 
cun de ces appels produit une permutation, qui est liabillee de code RTF par le modele 

i nstanci er-i ndexEntry, 

<xsl :template name="instancier-XEntry"> 
<xsl iparam naine="bl ankNumber"/> 
<xsl iparam naine="stringToSpl it"/> 

<xsl ivariable name="before_after"> 

<xsl :cal 1 - tempi ate naine="instancier-stringSplits"> 

<xsl :with-param name="bl ankNumber" sel ect="$bl ankNumber"/> 
<xsl :with-param name="stringToSplit" select="$stringToSplit"/> 
</xsl :call-teinplate> 
</xsl :variable> 

<xsl :variable name="wordsBefore"> 

<xsl :val ue-of sel ect="$before_after//before" /> 
</xsl :variable> 

<xsl :variable name="wordsBefore-paren"> 

<xsl :choose> 

<xsl :when test="normalize-space($wordsBefore)"> 

(<xsl :value-of select="$wordsBefore" />) 
</xsl :when> 

<xsl :otherwise> 
</xsl :otherwise> 
</xsl : choose> 

</xsl :variable> 

<xsl :variable name="wordsAfter"> 

<xsl :val ue-of sel ect="$before_after//after" /> 
</xsl :variable> 

<xsl :variable name="theEntry"> 

<xsl :val ue-of sel ect="$wordsAfter"/><xsl :text> </xsl:text> 

<xsl :value-of sel ect="$wordsBefore-paren"/> 
</xsl :variable> 

<xsl :cal 1 -tempi ate name="i nstanci er-indexEntry"> 

<xsl :with-param nanie="entry" sel ect="$theEntry"/> 
</xsl :call-template> 

</xsl itempl ate> 
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<!--> 



<!--> 

<xsl :template naine="instancier-XEntries"> 
<xsl :parani name="l istOfNumbers"/> 
<xsl : pa ram name="stringToSpl it"/> 

<xsl :choose> 

<xsl :when test="contains($listOfNumbers, ',')"> 

<xsl ivariable naine="aNumber"> 

<xsl :value-of select="substring-before( SlistOfNumbers, ',')"/> 
</xsl :variable> 

<xsl : cal 1 -tempi ate name="instancier-XEntry"> 

<xsl iwith-param name="bl ankNumber" sel ect="$aNumber - !"/> 
<xsl :with-param name="stringToSpl it" select="$stringToSpl it"/> 

</xsl :call-template> 

<xsl :cal 1 -tempi ate name="instancier-XEntries"> 

<xsl iwith-param name="l istOfNumbers" 

select="substring-after($listOfNumbers, ' , ' )"/> 

<xsl :with-param name="stringToSpl it" select="$stringToSpl it"/> 
</xsl :call-template> 

</xsl :when> 

<xsl :otherwise> 

<xsl:if test="$li stOf Numbers"> 

<xsl :choose> 

<xsl:when test="nuiiiber($l istOfNumbers) = !"> 

<xsl :cal 1 -tempi ate name="instancier-indexEntry"> 
<xsl iwith-param name="entry" 

sel ect="$stringToSpl1 t"/> 

</xsl :call -template> 
</xsl :when> 

<xsl :otherwise> 

<xsl icall-template name="instancier-XEntry"> 
<xsl :with-param name="bl ankNumber" 

sel ect=" number ($1 istOfNumbers )-!"/> 
<xsl :with-param name="stringToSpl it" 

sel ect="$stringToSpl i t"/> 

</xsl :call -template) 
</xsl :otherwise> 
</xsl :choose> 
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</xsl :if> 

</xsl :otherwise> 
</xsl :choose> 



</xsl itempl ate> 



<!--> 



<!--> 

<xsl :template name="instancier-indexEntry"> 

<xsl:parain naine="entry"/> 

<xsl :text>{\xe \v{</xsl :text> 

<xsl : val ue-of sel ect= "normal ize-space($entry ) "/> 

<xsl :text>}}</xsl :text> 
</xsl itempl ate> 

<!--> 



<!--> 

<xsl itempl ate match='index'> 

<xsl ivariable name="wordNumbers"> 

<xsl :value-of select="@indexWords"/> 
</xsl :variable> 

<xsl :variable name="entries"> 
<xsl :val ue-of select="."/> 
</xsl :variable> 



<xsl :choose> 

<!-- cas ou il y a une liste de numeros de mots --> 
<xsl :when test="normalize-space($wordNumbers)"> 



<xsl :call-template name="instancier-XEntries"> 

<xsl :with-param name="l istOfNumbers" sel ect="$wordNumbers"/> 
<xsl :with-param name="stringToSplit" 

sel ect=" normal ize-space($entries) "/> 

</xsl :call-template> 
</xsl :when> 

<!-- cas ou il n'y a pas de liste de numeros de mots : --> 
<!-- le contenu constitue 1 'entree d'index --> 
<xsl :otherwise> 

<xsl :variable name="theEntry"> 
<xsl :apply-templates/> 

</xsl :variable> 
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<xsl :cal 1 - tempi ate nanie="instancier-inclexEntry"> 
<xsl iwith-param name="entry" 

sel ect=" normal ize-space($theEntry) "/> 

</xsl :call-template> 
</xsl :otherwise> 



</xsl :choose> 



</xsl itempl ate> 

Etant donne une chatne s composee de mots separes par des apostrophes ou des espaces, 
et un nombre i fournis en donnee, le modele nomme instancier-stringSpiits a pour 
but de produire 3 morceaux de chaines de caracteres : la sous-chaine de s situee avant le 
ieme separateur, le separateur, et la sous- chaine de s situee apres le ieme separateur. 

Cette fonction repose sur une definition recursive de la notion « d 'avant et d'apres le 
ieme Separateur ». Si on appelle s la chaine donnee, et t la chaine s privee de son pre- 
mier mot, on peut dire que (conformement ace qui estmontre par la figure A- 1) : 

• ce qu'il y a apres le i eme separateur dans s, c'est ce qu'il y a apres le i-i eme sepa- 
rateur dans t ; 

• ce qu'il y a avant le i eme separateur dans s, c'est ce qu'il y a avant le i-i eme sepa- 
rateur dans t, concatene au premier mot de s. 

Cette definition vaut pour i superieur a 1 ; lorsque i estegal a 1, c'est un cas trivial, puis- 
quelesfonctionsXSLT predefinies substring-beforec ) et substring-afterc ) donnent 
directement le resultat cherche, 

On notera que la recursion, ici, n'est pas terminale, a cause de la concatenation a effectuer 
a partir du resultat obtenu recursivement. II serait possible de la rendre terminale, mais ce 
n'est pas du tout une necessite, car la profondeur de recursion est egale au nombre 
d'entrees a generer pour une meme phrase, qui n'est jamais tres grand (presque toujours 
infeheur a 5). 



Figure A-l 

Decoupaged'unechaine 
en 3 morceaux. 



avant 



s 
t 



I - 1 



apres 



avant 



apres 



Void le modele nomme instancier-stringSplUs 

<xsl itemplate name="instancier-stringSplits"> 
<xsl:param name="bl ankNLimber"/> 
<xsl : pa ram name="stringToSpl it"/> 
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<xsl :choose> 

<!-- = --> 
<!-- = --> 

<xsl :when test="$bl ankNumber = 1"> 

<xsl :variable name="result"> 
<xsl icall-template 

nanie="stringSpl i ts-beforeAndAfter-f i rstSeparator"> 

<xsl :with-param name="stringToSplit" 

sel ect="$stringToSpl i t"/> 

</xsl : call -tempi ate> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 

</xsl :when> 

<!-- = --> 
<!-- = --> 

<xsl :when test="$bl ankNumber = 0"> 

<xsl :variable name="result"> 
<split> 

<before/> 
<after> 

<xsl :val ue-of select="$stringToSpl it" /> 
</after> 
</split> 
</xsl :variable> 

<xsl:copy-of sel ect="$resul t" /> 

</xsl :when> 

<!-- = --> 
<!-- = --> 
<xsl :otherwise> 

<!-- = --> 

<xsl :variable name="before_after"> 
<xsl :cal 1 -tempi ate 

name="stringSpl i ts-beforeAndAfter-f i rstSeparator"> 

<xsl :with-param name="stringToSplit" 

sel ect="$stringToSpl i t"/> 

</xsl : cal 1 -tempi ate> 
</xsl :variable> 



<!-- = --> 
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<xsl :variable naine="before"> 

<xsl :value-of select="$before_after//before" /> 
</xsl :variable> 

<!-- = --> 

<xsl ivariable name="separator"> 

<xsl :value-of select="$before_after//separator" /> 
</xsl :variable> 

<!-- = --> 

<xsl ivariable name="after"> 

<xsl :val ue-of select="$before_after//after" /> 
</xsl :variable> 

<!-- = --> 

<xsl ivariable naine="recurs1ve_before_after"> 

<xsl :call -template name="instancier-stringSpl 1ts"> 
<xsl :w1th-param name="bl ankNumber" 

sel ect=" number ($bl ankNumber )-!"/> 
<xsl iwlth-param name="str1ngToSpl1t" select="$after"/> 
</xsl :call-teniplate> 
</xsl :variable> 

<!-- = --> 

<xsl :variable name="result"> 
<split> 

<before> 

<xsl :value-of select="concat( $before, 

$recursi ve_before_after//before)"/> 

</before> 
<after> 

<xsl :value-of select="$recurs1ve_before_after//after"/> 
</after> 
</split> 
</xsl :variable> 

<!-- = --> 

<xsl:copy-of sel ect="$resul t" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl itempl ate> 



Feuille de style complete 

La feuillede style complete, ainsi que la DTD, est disponiblesur le site internet des edi- 
tions Eyrolles : www.editions-eyrolles.com (taper D rix dans leformulaire de recherche rea- 
pide), 



B 



Les instruction menageres 



Les instructions XSLT que nous appelons menageres sontdes instruction qui serventa regler 
quelques parametres pour la lecture de la source X M L ou I 'ecriture du document resultat, 

Cela COncerne les instructions xsl :stylesheet, xsl mamespace-allas, xsl:output, 
xsl : decimal - format, xsl : preserve- space, etxsl :strip-space. 

Instruction xsl: stylesheet 
Syntaxe 

xsl :sty1esheet 

<xsl :stylesheet 
version="1.0" 

/> 

OU 

xsl :transfortii 

<xsl itransform 
version="1.0" 

/> 

L'element xsi :styiesheet est la racine d'un document XSLT. xsi :transform est un 
synonyme de xsi :styiesheet. L'attribut version est obligatoirement egal a 1,0, du 
moinstant que la version 2.0 nesera pas officiellementdisponible. 

Note 

La version 1.1 ne sera jamais officiellementdisponible. 



H Les instruction menageres 

Variantes syntaxiques 

xsl : stylesheet 

<xsl :stylesheet 
version="1.0" 

extension -el ement-pref ixes=" " 

excl ude-resul t-pref ixes=" " 

/> 

L a valeur de ces deux attributs facultatifs est fournie sous la forme d'une liste de prefixes 
separes par des espaces blancs. 

Attribut extension-element-prefixes 

Cet attribut permet au processeur XSLT dedistinguerdeselementsXML litteraux ains- 
tancier tels quels et des elements XML qui se trouveraient etre en realite de nouvelles 
instructions XSLT proposees comme extensions partel outel processeur particulier. Les 
prefixes a fournir doivent bien sur faire partie des prefixes declares avec les domaines 
nominaux dans instruction xsi :styiesheet elle-meme. 

Par exemple, I'extension <saxon:entity-ref name="nbsp"/> permet d'emettre dans le 
fichier de sortie la reference a I'entite nbsp propre a HTM L. Pour I'utiliser, 11 faut done 
declarer le domaine nominal de Saxon, puis le prefixe correspondant (saxon, en I 'occur- 
rence) dans la liste des extension-eiement-prefixes. Ci-dessous un exemple, qui 
reprend I'exemple vu a la section Realisation avec recherche par expression XPath, 
page 473 : 

Saison.xsl 

, <?xml version="1.0" encoding="LITF-16"?> 
<xsl :stylesheet 

xinlns:xsl=" http://www.w3.org/1999/XSL/Transform" 
xml ns :saxon="http: //i cl .com/saxon" 
extension -el ement-pref1xes=" saxon" 
version="1.0"> 

<xsl:output method^'html ' encoding='IS0-8859-r /> 

<xsl itemplate match="/"> 
<html> 
<head> 

<title>Prograinme Saison 
<xsl :val ue-of 

sel ect=" /Saison /Peri ode "/></t1tle> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-teniplates/> 
</body> 
</html> 
</xsl :template> 
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<xsl : tempi ate niatch="Saison"> 

<xsl lapply-templates select="Manifestations"/> 
<H3>Adresses :</H3> 

<xsl lapply-templates sel ect="Adresse"/> 
</xsl itempl ate> 

<xsl itemplate match="Concert|Theatre"> 

<H3><xsl :val ue-of sel ect="l ocal -name( . ) "/> </H3> 
<p><saxon : entity- ref name="nbsp"/> 
<saxon : entity- ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
Date : <xsl :value-of sel ect="Date"/> <br/> 
<saxon:entity-ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
<saxon:entity-ref name="nbsp"/> 
Lieu : <a href="#{generate-id( 

/Saison/Adresse/Lleu 
[ . = current( )/L1eu ])}"> 
<xsl :val ue-of sel ect="L1 eu"/> 
</a> 

</p> 
</xsl :temp1 ate> 

<xsl : tempi ate match="Adresse"> 

<p><a name="#{generate-1d( ./Lieu))"> 
<xsl :value-of select="L1eu"/></a><br/> 
<xsl :val ue-of sel ect=" ./child: :text( )[2]"/> 
</p> 

</xsl rtempl ate> 

<xsl : tempi ate match="text( )"/> 



</xsl :stylesheet> 

Etvoici cequeceladonne: 

Sai son .html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<t1tle>Programme Saison Automne 1999 </title> 
</head> 
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<body bgcol or="white" text="bl ack"> 
<H3>Concert</H3> 
<p> &nbsp:   

Date : Samedi 9 octobre 1999 20H30 <br> 

     

Lieu : <a href="#d0e56">Chapel 1 e des Ursul es</a></p> 
<H3>Th&eacute:âtre</H3> 
<p> &nbsp:   

Date : Mardi 19 novembre 1999 21H <br> 

&nbsp: &nbsp:  

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Th&eacute:âtre</H3> 
<p>     

Date : Mercredi 20 novembre 1999 21H30 <br> 

     

Lieu : <a href="#d0e62">Sal 1 e des Cordel iers</a></p> 
<H3>Adresses :</H3> 

<p><a name="#d0e56">Chapelle des Llrsules</a><br> 
9. rue des Ursules - 49000 Angers 

</p> 

<p><a name="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Prévoyants de I'avenir - 49000 Angers 

</p> 
</body> 
</html> 

Attribut exclude-result-prefixes 

Cet attribut demande au processeur de ne pas emettre de declaration de domaine nominal 
pour les domaines nominaux references par les prefixes fournis comme valeur de cet 
attribut. 

Comme le processeur XSLT est oblige degenererun document XML correct, il passera 
outre votre demande, si le domaine nominal que vous voulez exclure du resultat est en 
fait utile. M ais si le domaine nominal vise est effectivement inutile dans le document 
genere, votre demande sera prise en compte. Le processeur XSLT ne peut pas deviner 
toutseul si un domaine nominal est vraiment inutile, parcequeXML autorise d'utiliser 
les domaines nominaux meme sur des valeurs d'attribut : 

<truc b1dule="mach1n:chose"> 

II n'est pas interdit d'avoir une valeur d'attribut qui soit "machin:chose" ; dans cette 
chaine de caracteres, "machin" est-il un prefixe, ou simplementle debut d'une valeur ou 
11 y a un ":" au milieu ? Si en plus il se trouve que machin est reellement un prefixe 
declare pour un certain domaine nominal, le processeur XSLT ne peut plus s'y retrouver 
poursavoirsi cedomaine nominal estutileou non. Done les processeurs XSLT n'ontpas 
a decider eux-memes ; c'est a vous de dire lesquels exclure. 
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Instruction xshnamespace-alias 

Syntaxe 

xsl :nainespace-a1 ias 

<xsl rnamespace-alias 

styl esheet-pref ix=" ..." 
resul t-pref ix=" ..." 

/> 



L'instruction xsi :namespace-aiias doit apparaitre comme instruction de premier niveau. 



Semantique 

L'instruction xsl :namespace-a lias permetde specifier qu'un element I itteral XML, pre- 
sent dans la feuille de style XSLT, et associe a un domaine nominal Nl, sera instancie 
dans le document resultat comme etant associe a un autre domaine nominal N2. Comme 
d'habitude, lesdomaines nominaux concernessontdesignes par les prefixes qui les iden- 
tifient, cequi rend leschoses un peu troubl antes, car on peutcroirequ'il s'agitseulement 
dechangerdeprefixe(sans changer de domaine nominal), alorsqu'il s'agitbel etbien de 
changer de domaine nominal (et accessoirement de prefixe, mais comme vous le savez, 
un prefixe n'a aucune importance en lui meme). 

Le prefixe du domaine nominal Nl est indique par I'attribut styiesheet-prefix, et le 
prefixe du domaine nominal N2 par I'attribut result-prefix, de sorte que l'instruction 
xsl :namespace-ai ias permettant de passer du domaine http://machin (prefixe mm:) au 
domaine http://truc (prefixe tt:) aura I'allure suivante : 

|<xsl :namespace-alias 
styl esheet-pref ix="mm" 
resul t-prefix="tt"/> 

Ceci ne veut pas du tout dire que les elements litteraux de prefixe mm: apparaitront dans le 
document resultat avec le prefixe tt : , mais que les elements litteraux de domaine nomi nal 
http: //machi n apparaitront dans le document resultat associes au domai ne nominal http : // 

true, 

Concretement : 
Concert.xinl 

<?xml version="1.0" encocling="UTF-16" standalone="yes"?> 
<Concert> 

<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 



<Interpretes> 
<Interprete> 
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<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Noin> Sylvia Abramowicz </Noni> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Interpretes> 

</Concert> 

Concert.xsl 

<?xirl version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns :xsl=" http://www.w3.org/1999/XSL/Transform" 
xml ns :niir="http: //machin" 
xml ns :tt="http: //true" 
version="1.0"> 

<xsl:output method^'xml ' encoding=' ISO-8859-r indent^'yes' /> 

<xsl mamespace-alias stylesheet-prefix="mm" resul t-pref ix="tt"/> 

<xsl itemplate match=" Interpretes"> 
<mm:Musiciens> 

<xsl :copy-of sel ect=" Interprete"/> 
</mm:Musiciens> 
</xsl itempl ate> 

<xsl itemplate match="text( ) "X/xsl :template> 
</xsl :stylesheet> 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mm:Musiciens xml ns:mm="http: //true" xmlns:tt="http://truc"> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
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</Interprete> 
</inm:Musiciens> 

Tout cela est assez admirable (plus admirable qu'imitable, d'ailleurs), mais a quoi cela 
peut-il bien servir ? 

L a pri nci pal e uti I i te est de pouvoi r ecri re une f eui 1 1 e de sty I e X S LT qui genere comme resul tat 
une autre feui lie de style XSLT. On sereportera a la section Pattern n° 15 -Generation d'une 
feuille de style par une autre feuille de style, page 507 pour en voir un exemple. 

En effet, si I'on ades instructions XSLT aemettredans leresultaten tantqu'elements lit- 
teraux, 11 fauttrouver un moyen pour que le processeur XSLT ne les prenne pas pour lui, 
en tant qu'instructions a executer. La solution est de declarer ces instructions dans un 
domaine nominal autre que celui d'XSLT, et de demander a ce que dans le document 
resultat, ces elements apparaissent dans le domaine nominal X SLT. 

Instruction xshfallback 

Syntaxe 

xsl tfallback 

<xsl :fallback> 

<!-- modele de transformation --> 
</xsl :fallback> 

L'lnstructlon xsi :xsi : fail back ne doit pas apparaitre comme instruction de premier niveau. 

Instruction XSLT typique 

U ne instruction X SLT utilisant I 'instruction xsi : f ai i back aura souvent la forme : 

<xsl :xxx> 

<!-- modele de transformation propre a xsl:xxx --> 
<xsl :fallback> 

<!-- modele de transformation propre a xsl:fallback --> 
</xsl :fallback> 
</xsl :XXX> 

L'effet de cette instruction est le suivant : si xsi :xxx est une instruction connue du pro- 
cesseurXSLT, instruction xsi :faiiback (etcequ'ellecontient) estignoree. Si xsi :xxx 
est une instruction inconnue du processeur XSLT, instruction xsi:faiiback qu'elle 
conti ent est instanciee. 

Cela sert dans lecasou on lance un processeur XSLT 1.0 sur un source XSLT d'une ver- 
sion ulteheure, contenant eventuellement des instructions qui n'existaient pas encore 
dans la 1.0, ou bien dans lecas ou I'on utilise des instructions hors norme (des extensions 
fournies par tel ou tel processeur) dans un programme source qui est susceptible d'etre 
traite par differents processeurs. 
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Instruction xshpreserve-space 

Instruction xsl:strip-space 

Syntaxe 



xsl :preserve-space 

<xsl :preserve-space elements=" 



xsl :strip-space 

I <xsl :strip-space elements=" 



"/> 



Les instructions xsi :preserve-space et xsl : stri p-space doivent apparaitre comme 
instructions de premier niveau. 



instruction <xsi :strip-space> sert a eliminer les noeuds text ne contenant que des 
espaces blancs de I'arbreXM L construit par le processeur XSLT. Voir la section Exem- 
ple, page 170, et la section Realisation avec recherche par expression XPath, page 473. 

L'instruction <xsi :preserve-space> permet de contredire localement instruction 
<xsi :strip-space>. Generalement, on nel'emploiepas seule, car son effetestl'effetpar 



Par exemple, pour activer la suppression des noeuds text blancs comme neige, sauf pour 
ceux qui sontdes enfantsde <truc> ou <biduie>, on ecrira : 

|<xsl :strip-space el ements="*"/> 
<xsl rpreserve-space el ements="truc bidule"/> 



xsl :OUtput 

<XSl :OUtput 

method = <!-- "xml" | "html" | "text" | name --> 

version = " . . . " 
encoding = " . . . " 

omit-xml-declaration = "..." <!-- "yes" | "no" --> 
standalone = "..." <!-- "yes" | "no" --> 
doctype-publ i c = <!-- string --> 

doctype-system = <!-- string --> 

cdata-section-elements = " " 

indent = <!-- "yes" | "no" --> 

media-type = <!-- string --> 



Semantique 



defaut. 



Instruction xsl:output 

Syntaxe 



/> 
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Tous les attributs sont facultatifs. 

L'instruction xsi :output doit apparattrecomme instruction de premier niveau. 



Semantique 

L'instruction xsi : output permet aux auteurs defeuilles de style de specifier la maniere 
dont ils souhaitent produire I'arbre resultat. Le processeur doit faire pour le mieux, 
sans etre oblige toutefois de suivre a lettre toutes les directives fournies par les diffe- 
rents attributs. 

Les attributs principaUX sont method, encoding et indent. Notamment I'attribut method 

est celui qui est le plus lourd de consequence sur I'aspect du document resultat. 

L'attri but method identifie la methode general e qui doit etre utilisee pour produire I'arbre 
resultat. Sa valeur doit etre un nom qualifie. S'il n'est pas prefixe, alors 11 identifie 
i'unedestroissuivantes : xmi, htmi ou text. Si lenom qualifie est prefixe, alors c'estune 
methode non standard fournie par un processeur particulier. 

En I'absence d'attribut method, le processeur tente de reconnattre la nature du fichier 
source; s'il reconnaitdel'HTM L, la methode par defaut sera 'htmi' ; si non ellesera 'xmi'. 

Lesautres attributs sont : 

• version : specifie la version de la methode de sortie (par exemple« 1.0 »). 

• indent : demandeou non ('yes' ou 'no') une indentation du fichier de sortie. 

• encoding : specifie le systeme d'encodage des caracteres du fichier de sortie. 

• media-type : specifie le type M IM E du fichier de sortie. 

• doctype-system : specifie I'identifiant systeme qui doitetre utilise dans la declaration 
deDTD. 

• doctype-pubi ic : specifie I'identifiant public qui doit etre utilise dans la declaration 
deDTD. 

• omit-xmi -declaration : demande OU non ('yes' OU 'no') une declaration XML en 
debut de fichier. 

• standalone : specifie la valeur ('yes' OU 'no') de la declaration standalone=« ... » 

• cdata-section-eiements : specifie une liste de noms d'elements dont les fils de type 
text doivent etre produits en tant que section CDATA dans I 'arbre resultat. 

La signification precise de ces attributs en fonction de la methode choisie (text, xmi ou 
html) est tres longue et sans grand interet d'un point de vue general. On se reportera au 
standard XSLT pour tel ou tel detail. 
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Instruction xshdecimal-format 

Syntaxe 

xsl :deciiiia1 -format 

<xsl idecimal -format 

name = " . . . " 

decimal -separator ="..." <!-- char --> 
grouping-separator = <!-- char --> 

infinity = <!-- string --> 

minus-sign = <!-- char --> 

NaN = <!-- string --> 

percent = <!-- char --> 

per-mille = <!-- char --> 

zero-digit = <!-- char --> 

digit = ". . ." <!-- char --> 
pattern-separator = <!-- char --> 

/> 

Tous les attributs sontfacultatifs. 

L'instruction xsi :decimai -format doit apparaitre comme instruction de premier niveau. 
Semantique 

Cette instruction s'utiliseexclusivementavec lafonction format-number( ), Ellen'a rien 
a voir avec instruction xsi :number, ni avec la fagon dont les conversions de String en 
nombre sont effectuees. II s'agit uniquement ici de format de sortie pour un nombredeja 
calcule par ailleurs. 

L'attribut name permet de declarer un format nomme, qui pourra etre ensuite reference 
dans un appel a la fonction format-number( ), en tant que troisieme argument. Si l'attri- 
but name est omis, I'instruction xsl :decimai -format specifie un format par defaut, qui 
pourra ensuite etre reference en appelant la fonction format-numbero avec seulement 
deux arguments. 

M isapart l'attribut name, les autres attributs correspondent aux couples demethodes get/ 
set de la classejava Decimal Formatsymbois du J DK 1.1 (une paire par attribut). 

Certains de ces attributs permettent de control er aussi bien I 'interpretation des caracteres 
du motif de format que de specifier ceux qui peuvent apparaitre dans le resultat de forma- 
tagedu nombre: 

• decimal -separator indique le caractere utilise pour marquer un point decimal ; la 
valeur par defaut est I e caractere point ' .'. 

• grouping-separator indique le caractere utilise comme separateur de groupes (par 
exemple milliers) ; la valeur par defaut est la virgule ' .'. 
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• percent indique le caractere utilise pour le signe pourcent ; la valeur par defaut est le 
caractere pourcent '%'. 

• per-miiie indique le caractere utilise pour le signe pour-mille; la valeur par defaut 
est le caractere U nicode pour-mille (#x203o). 

• zero-digit indique lecaractere utilise pour lechiffrezero ; la valeur par defaut est le 
chiffrezero 'o'. 

D'autres controlent I'interpretation des caracteres dans le motif de format : 

• digit indique le caractere utilise pour un chiffre dans le motif de format ; la valeur 
par defaut est le caractere diese 

• pattern-separator indique le caractere utilise dans un motif, pour separer les sous- 
motifs representant des nombres positifs des sous motifs representant des nombres 
negatifs ; la valeur par defaut est le caractere point-virgule ' :'. 

Enfin ceux-ci indiquent les caracteres ou les chaines de caracteres pouvant apparaitre 
dans le resultat de formatage d'un nombre : 

• infinity indique la chaine de caracteres utilisee pour representer I'infini ; la valeur 
par defaut est la chaine de caracteres inf i ni ty. 

• NaN indique la chaine de caracteres utilisee pour representer la valeur de NaN (Not a 
Number) ; la valeur par defaut est la chaine de caracteres NaN , 

• minus-sign indique le caractere utilise comme signe moins par defaut ; la valeur par 
defaut est I e caractere moi ns ( -, *<2D ) , 



Exemple 

Concert.xml 

<?xml version="1.0" encocling="UTF-16" standalone="yes"?> 



<Concert> 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Compositeurs> 

<Conipos1 teur>M. Marais</Coniposi teur> 

<Conipos1 teur>D. Castel lo</Compositeur> 

<Conipos1 teur>F. Rognoni</Compos1 teur> 

</Compositeurs> 
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<Tarif> 

<plein> 15.0 </plein> 
<reductions> 

<jeune>40</jeune> 
<groupe>30</groLipe> 
</reductions> 
</Tarif> 

</Concert> 

Concert.xsl 

<?xml version="1.0" encoding="LITF-16"?> 

<xsl :stylesheet xnilns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method^'html ' encoding='IS0-8859-r /> 

<xsl :templ ate match="/"> 
<html> 
<head> 

<ti tleXxsl : val ue-of sel ect=" /Concert /Entete'VX/titl e> 
</head> 

<body bgcolor="white" text="bl ack"> 

<xsl :apply-teniplates/> 
</body> 
</html> 
</xsl :templ ate> 

<xsl itempl ate match="Date"> 

<H1 al ign="center"> Concert du <xsl :value-of select="."/> </Hl> 

<H4 al ign="center"> <xsl :value-of select="/Concert/Lieu"/> </H4> 

<H3 al ign="center"> <xsl :value-of select="/Concert/TitreConcert"/></H3> 

</xsl :templ ate> 

<xsl itempl ate match="Lieu"> 
</xsl itempl ate> 

<xsl itempl ate match="Ensemb1 e"> 

<H2 al ign="center"> Ensemble <xsl ival ue-of sel ect=" . "/></H2> 
</xsl itempl ate> 

<xsl idecimal -format 
name="prix" 
decimal -separator=" , " 
grouping-separator^" . " /> 

<xsl itempl ate match="Tari f "> 

<xsl ivariable name="plein" select="./plein"/> 

<xsl ivariable name="reducJeune" select="./reductions/jeune"/> 

<xs1 ivariable name="reducGroupe" select=" . /reductions /groupe"/> 
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<xsl ivariable 
nanie="jeune" 

select="$plein - ( Splein * $reducJeune div 100 ) "/> 

<xsl ivariable 
nanie="groupe" 

select="$plein - ( Splein * SreducGroupe div 100 ) "/> 
<P>Tarifs : <br/> 

<xsl :value-of sel ect="forinat-number( 

Splein, '##,00', 'prix' )"/> Euros <br/> 

<xsl :value-of sel ect="format-number( 

Sjeune, '##,00', 'prix' )"/> Euros ( jeunes) ,<br/> 

<xsl :value-of sel ect="format-number( 

Sgroupe, '##,00', 'prix' )"/> Euros (groupes). 

</P> 
</xsl :templ ate> 



</xsl :stylesheet> 

Resultat 

<htnil> 
<head> 

<nieta http-equiv="Content-Type" content="text/htnil ; charset=IS0-8859-l''> 

<title> "Les Concerts d'Anacréon" </title> 
</head> 

<body bgcolor^'white" text="bl ack"> 

"Les Concerts d’Anacréon" 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 
<H4 align="center">Chapelle des Ursules</H4> 
<H3 align="center"></H3> 

<H2 al ign="center"> Ensemble "A deux violes esgales" </H2> 

M. Mara is 

D. Castello 

F. Rognoni 

<P>Tarifs : <br>15,00 Euros <br>9,00 Euros ( jeunes) ,<br>10, 50 Euros (groupes). 
</P> 
</body> 
</html> 
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Extensions 

Les extensions sontdesajouts a la W3C Recommendation XSLT 1.0, leseul standard actuel- 
lement existant (en fevrier 2002). Ces ajouts concernent la definition et I 'implementation 

• de nouvellesfonctionsXPath ou XSLT ; 

• ou denouvelles instructions XSLT ; 

• ou denouveaux attributs pour des instructions XSLT existantes. 

Historiquement, ces extensions ont ete d'abord proposees et implementees par les 
concepteurs de processeurs XSLT, puis une initiative de « standardisation » est ensuite 
apparue pour tenter d'harmoniser les extensions les plus communes, et meme pour pro- 
poser aux fournisseurs de processeurs des extensions original es. Cette initiative a pris le 
nom d'EXSLT, et ses travaux sont disponibles sur le site www.exsit.org. Citons aussi la 
XSLTSL (XSLT Standard Library, xsltsl.sourceforge.net) qui est une une bibliotheque de 
modeles nommes « 100% pur XSLT » : ce ne sont done pas a proprement parler des 
extensions, mais certains de ces modeles nommes peuvent parfois recouper certaines 
fonctions proposees par EX SLT. 

Les extensions sont generalement des reponses a la pression des utilisateurs et de la 
concurrence entre fournisseurs de processeurs. Certaines comblent des lacunes du stan- 
dard W 3C X SLT 1.0, d'autres ne comblent aucune lacune proprement dite mais ouvrent 
des perspectives nouvelles de traitement, et d'autres enfin sont des extensions de contort, 
qui simplifient beaucoup la programmation, ou qui ameliorent les performances par 
rapport a une solution « 100% pur XSLT ». 

Dans la categorie des extensions comblant des lacunes, on peut citer en tout premier lieu 
la fonction deconversion d'un RTF en node-set. On peutdirequ'unetellefonction estde 
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loin la plus necessaire de toutes les extensions ; mais comme nous en avons deja beau- 
coup parle (voir Temporary SourceTree, page 192 etOpe'rations sur un RTF (XSLT 1.0), 
page 209), il nesera pas utile d'y revenir ici dans le detail. 

U ne autre lacune tres genante de X SLT 1.0 est I 'impossibilite d'ecrire une feuille de style 
qui produise en resultat plusieurs documents. C'est pourtant un besoin evident, notam- 
menten HTM L, si I 'on veut par exempleproduireun resultat decoupe en plusieurs pages 
differentes, ne serait-ce que pour generer des <f rame> et des <f rameset>, ou un ensemble 
de pages qui se referencent mutuellement (voir par exemple le pattern Pattern n°20 - 
Generation de documents multiples, page 563). 

Enfin une derniere lacune est la faiblesse des possibilites de traitement de dates. XSTL 
2.0 devrait retablir la situation, mais en attendant, on trouvera dans la XSLT Standard 
L i brary (http://xsltsi.sourceforge.net) beaucoup de choses i nteressantes dans le domai ne du 
traitement des dates, meme s'il est impossible de couvrir tous les besoins uniquement 
avec une bibliotheque de modeles nommes : le type date n'existant pas en tant que tel 
dans XSLT 1.0, il est par exemple impossible defaireun tri chronologique sur des dates 
avec I 'instruction <xsi :sort>. 

Dans la categorie des extensions ouvrant des perspectives de traitement, citons tout 
d'abord la fonction (reclamee par beaucoup d'utilisateurs) d'evaluation dynamique 
d'une expression XPath donnee sous forme d'une String. Un contexte souvent invoque 
pour justifier son utilisation est celui de la realisation de mises en pages pilotees par 
un document XM L auxiliaire, specifiant disposition etcontenu dans un format convenu, 
et comportant entre autres des expressions XPath a interpreter dynamiquement 
(voir Pattern n° 19 - Construction dynamique de I 'agencement d'un tableau HTM L, 
page 540). 

Une autre extension, un peu dans le memeordred'idee, est un attribut nouveau pour I 'ins- 
truction <xsi : call -tempi ate> (voir aussi Pattern n°19 - Construction dynamique de 
I 'agencement d'un tableau HTML, page 540), qui indique que I'attribut name est fourni 
sous la forme d'un descripteur de valeur differee d'attribut (chose normal ement interdite) : 
lenom du modele a appeler est ainsi calcule a I'execution, cequi eviteeventuellementun 
<xsi :choose> avec de nombreux cas possibles (un cas par modele a appeler). 

II fautciter aussi I espossibi I itesde connexion a unebasededonneesrelationnelle, au tra- 
vers d'instructions nouvelles, qui permettent done a une feuille de style de recevoir une 
requete, de la repercuter sur une base de donnees, d'obtenir une reponse, et de la ren- 
voyerdecoreeen HTM L (par exemple). 

Etpourfinir, il y a I'instruction (generalement nommee <xx:script>) qui permetd'imple- 
mentersespropres extensions en Java, Javascript, etc., cequi permeten parti cul ierd'instal- 
ler sur un processeur (qui fournit cette extension xxrscript) une extension propre a un 
autre processeur, pourvu qu'on aitlessourcesjavaoujavascriptdel'extension, 

Enfin, dans la categorie des extensions de contort, on trouve beaucoup de choses diffe- 
rentes. Par exemple des instructions permettantde retrouver la programmation habituelle 
avec les bonnes vieilles affections ou la boucle while. On trouve aussi des fonctions 
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redondantes avec les possibilites natives de XSLT 1.0, maisqui apportent un gain de per- 
formance ou de simplicite appreciable (par exemple une fonction qui renvoie intersec- 
tion de deux node-sets, ou bien une instruction qui permet de faire des regroupements 
sans avoir a les programmer dans le detail). 

Toutes ces extensions sont bien sflr dependantes du processeur utilise : certaines exten- 
sions ne sont pas supportees par certains processeurs, et lorsqu'une meme extension est 
supportee par plusieurs processeurs, les denominations sont generalement differentes 
(nodeseto, node-seto, nodeSeto, etc.), et les domaines nominaux a declarer pour 
prefixer ces extensions sont a coup sur differents. Sauf si ... 

... Sauf si c'est une extension disponible sur EXSLT, et que le processeur utilise la four- 
nit. Auquel cas, la denomination et le domaine nominal sont definis par EXSLT, et non 
par lefournisseur du processeur, cequi garantit la portabilite. Autrement, si I'on veut une 
feuillede style utilisantdes extensions et compatible avec un ensemble de processeurs, 11 
n'y a guere d'autre solution que de maintenir differentes versions de cette feuille de style, 
cequi n'est pas une situation tres enviable, 11 fautbien I'avouer. 

Pour une liste precise et a jour des extensions disponibles avec chaque processeur, il 
fautse reporter a sa documentation ; par exemple : http://saxon.sourceforge.net/ ou http:// 
xml.apache.org/xalan-j/. 

Evolutions : XSLT 2.0 etXPath 2.0 

Si les extensions sont le fait des concepteursde processeurs XSLT, les evolutions, elles, 
sont dues aux travaux du XSL Working Group du W3C, dont le but est de les proposer, 
puis de les stabiliser sous la forme d'une Final Recommendation. 

La seulerecommandation finale pour XSLT, a la dated'ecrituredecelivre (fevrier 2002), 
est celle du 16 novembre 1999 : c'est le standard XSLT 1.0. Bien sflr, des le debut des 
extensions ont commence a apparaitre, certaines fort pertinentes, et un groupe de travail 
s'est constitue pour prendre en compte le mieux possible certaines de ces extensions, et 
faire evoluer XSLT en 1.1. M ais les changements apportes ou proposes par la derniere 
version du Worl<ing Draft XSLT 1.1 (24 aout 2001) etaienttrop importants pour que cette 
evolution puisse passer pour mineure. A ussi cette version a-t-elleete abandonneeen tant que 
telle, et les propositions qu'elleavangait ontete incorporees au chantier de la version 2.0 du 
langage. Deux Working Drafts (XSLT 2.0 etX Path 2.0) sont parus le 20 decembre 2001, 
qui ouvrentde nouvelles perspectives sur ces langages. Bien sflr, rien n'est encore joue, 
et des evolutions importantes dans un sens ou dans I 'autre peuvent etre encore possibles 
d'ici la parution d'une Final Recommendation. On peut tout de meme tenter une breve 
sy nthese de ces evol uti ons. 

Perspectives pour XSLT 2.0 

Une premiere evolution, qu'on peut penser relativement peu sujette a etre remise en 
cause, concerne la redaction de la specification du langage. La version XSLT 1.0 etait un 
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peu spartiate par bien des cotes, et beaucoup trop concise sur certains points, ce qui ren- 
dait la lecture assez ardue. D 'autre part, certains termes, comme template, etaient trop 
charges de sens differents suivant les contextes. U n effort a done ete fait, pour repenser la 
redaction, la completer, la rendre plus facile a lire et a comprendre, et pour proposer de 
nouveaux termes (par exemple content constructor, et non plus template) pour designer 
un model e de transformation. A noter que dans ce livre, cet effort a ete anticipe, puisque 
nous avions choisi ce terme de module de transformation bien avant que ne paraisse le 
WD XSLT 2.0. 

Les autres evolutions concernent le langage proprement dit; certaines sont mineures, 
d'autres sont majeures. Nous listerons certaines des evolutions majeures, pour donner 
une idee de la direction que va prendre XSLT. 

M al fames, les RTF (Result Tree Fragment, voir Temporary Source Tree, page 192) ont 
ete repudies, etcommeXSLT 1.1 leproposait, un Temporary Source Tree accroche a une 
variable est vu comme un objet detype node-set, Done tout ce qui a ete explique dans la 
section referencee ci-dessus est maintenu. 

Les programmes XSLT pourront creer plusieurs documents resultats, avec la nouvelle 
instruction <xsi :resuit-document>, qui fonctionne d'une fa§on largementinspireedece 
que propOSait <xsl :document> deXSLT 1.1. 

Une instruction <xsi :for-each-group>, allant de pair avec une nouvelle fonction cur- 
rent-group( ), a ete introduite pour faciliter les regroupements (voir Pattern n°14 - 
Regroupements, page 474. 

II sera possible d'ecri re non pi us des modeles nommes, mais de veritablesfonctions, que 
I'on pourra appeler dans des expressions XPath sans etre oblige d'utiliser le tank 

<xsl : call -tempi ate>. POUr Cela, leS instructions <xsl :function> et <xsl :result> Ont 

ete proposees. 

On peut done resumer tout ceci est disant que globalement, il sera a I'avenir moins ardu 
de programmer en XSLT, notamment grace a introduction de la notion de fonction, et 
decellederegroupement. 



Perspectives pour XPath 2.0 

En cequi concerne XPath, il s'agit plus d'une revolution qued'unesimpleevolution. 
En effet, un nouveau langage, XQuery 1.0, a ete defini, et sa definition repose sur 
XPath 2,0. Ce qui veut dire que les groupes de travail XSL et XM L Query ont joint 
leurs forces pour definir de fagon commune le langage XPath 2.0. Autant dire que 
X Path prend une nouvelle orientation, afin de convenir a la fois aux besoins de X SLT 
etde XQuery. 

Pour comprendre cette evolution, il faut savoir que XQuery est un langage XM L de 
requetes sous forme d'expressions ; ces expressions obeissent a une grammaire qui est un 
sur-ensemblede XPath 2.0. D'une certainemaniere, on peut dire que les langages XSLT 
et XQuery sont a la fois complementaires et redondants suivant la fa9on dont on les 
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analyse. Complementaires parce que le domaine d'XSLT est plutot celui de la transfor- 
mation que celui delarequete; redondants parce que XSLT etX Query fournissenttous 
les deux le moyen d'exprimer des recherches dans un document XML arbitral rement 
complexe, maisanouveau complementaires, meme dans ce domaine, parce que X Query 
est clai rement plus simple a utiliser queX SLT pour exprimer des requetes complexes, et 
surtout est congu pour favoriser une optimisation tres poussee de ces requetes, de la 
meme fagon que SQL a ete a I'origine d'optimisations tres fines des moteurs de bases de 
donnees relationnelles. 

Les evolutions d'XPath portent d'abord sur le modele de donnees utilise : desormais, 
XPath repose sur les types simples definis par les Schemas XML (www.w3.org/TR/ 
xmlschema-2) ; d'autre part, XPath offre maintenant la notion de Sequence, qui est une 
liste ordonnee de valeurs, et qui vient done en complement de la notion d'arbre, qui etait 
jusqu'a present la seule structure de donnees uti 11 sable. 

XPath 2.0 introduitde plus des extensions aux constructions existantes, etdesoperateurs 
nouveaux. Par exemple, la notion d'etape de localisation a ete etendue a celle d'etape 
generalisee, qui peut faire intervenir une expression XPath, ce qui permet d'ecrire des 
choses comme : 

I partie/(chapitre | annexe) /pa rag raphe 

ou comme 

I documentC "true. xml " )/key ("..." , "...") 

Des expressions nouvelles apparaissent, notamment I'expression for/return (qui 
retourne une Sequence de valeurs), I'expression if (qui retourne une valeur parmi deux 
possibles, suivant une condition), et I'assertion booleenne quantifiee some/every/ 

sati f i es, 

Exemples : 

Expression for/return 

for $a in distinct-values(//author) 
return ( 

$a. 

for $b in //book[$b/author = $a] return $b/title 

) 

Expression if 

if (gpseudonyme) 
then ©pseudonyme 
el se @nom 

Assertion quantifiee 

I some $enip in //employee satisfies 
($emp/bonus > 0.25 * $emp/salary) 
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Enfin de nouveaux operateurs sont proposes, == pour tester I'identite de deux noeuds, et « 
pour tester I'ordred'apparition dedeux noeuds au sein d'un meme document. Exemples : 

Exemples : 

Test d'identite 

//book[@isbn = '12345'] == //author[@name='dudule']/book[l] 

Test d'anteriorite (ordre de lecture du document) 

, //book[@isbn = '12345'] « //book[@isbn = '54321'] 

On voit done que X Path change completement de statut : avant c'etait un humble servi- 
teur deXSLT, desormais il est le socle sur lequel sera bati le langage X Query (et dans 
une moindre mesureXSLT). Et comme il est probable qu'a I'avenir il ne sera plus suffi- 
sant de connaitre uni quement X SLT, car certai nes appi i cati ons devront uti I i ser conj oi nte- 
mentXSLT etXQuery pouretrevraiment performantes, on peut penser que I 'importance 
de X Path ne fera que croitre. 
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Notations 

Les mots en italique sont des symboles terminaux (c'est-a-dire non definis dans les 
regies syntaxiques). 

Les accolades { } font partie de la syntaxe decrivant certains attributs. Elles denotent la 
possibilite d'utiliser desAVT (Attribute Value Template), ou descripteur de valeur diffe- 
ree d'attribut. La oil 11 n'y a pas d'accolades, c'est que I'emploi de descripteur de valeur 
differeed'attributest interdit. 

Certaines notations propres aux DTD sont reprises ici : 

• X* signifie que x peut apparaitre 0, 1 ou plusieurs fois ; 

• X? signifie que x peut apparaitre 0 ou 1 fois ; 

• x+ signifie que x peut apparaitre 1 ou plusieurs fois ; 

• X I Y signifie que X peut apparaitre ou que Y peut apparaitre; 

• "X" signifie que x doit apparaitre litteralement. 

Symboles terminaux 

qname 

L e symbol e qna me veut dire Qua I i^ed Name. Un nom qualifie estun nom XM L avec ou 
sans prefixe, comme par exemple true ou f o : bi ock, 

ncname 

Lesymbolencnameveut dire Non Colonized Name. C'est un nom XML sans prefixe. 
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qname-but-not-ncname 

Lesymboleqname-but-not-ncname estun nom XM L obligatoirement prefixe, 
prefix 

Un pre^x estun ncnamequi sertde prefixe dans unqname. 
uri-reference 

Le symbole uri-reference veut dire U nique Resource Identifier. C'est une generalisation 
dela notion d'URL, qui pour I 'instant n'est pas encore vraimentstabilisee. On peut done 
considererqueURI etURL sont synonymes. 

pattern 

Le symbole pattern veut dire ici motif, 
expression 

U ne expression veut dire une expression X Path quelconque. 
node-set-expression 

Une node-set-expression est une expression X Path qui renvoieun node-set. 
boolean-expression 

Une boolean-expression est une expression X Path qui renvoie une valeur booleenne. 
number-expression 

U ne number-expression est une expression X Path qui renvoie nombre. 
string-expression 

Une string-expression est une expression X Path qui renvoie une String, 
nmtol<en 

Un nmtol<en (Name Token) est une suite decaracteresval ides pour former un nom XM L, 
nametest-tolcens 

U n nametest-tokens est une suite de nametest separes par des espaces blancs. U n name- 
test est un determinant, intervenant dans une etape de local isationX Path. Un nametest 
peutetre un qname, ou uneetoile, ou uneetoile prefixee (par exemple "fo:*"), 

ncname-tolcens 

U n ncname- tokens est une suite de ncname separes par des espaces blancs. 
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Regies syntaxiques 

Instruction xsl lapply-imports 

I <xsl :apply-imports /> 

Instruction xsl lapply-templates 

<xsl lapply-templates 

select = node-set-expression 
mode = qnanie> 

<!-- Contenu : (xsl:sort | xsl iwith-param)* --> 
</xsl :apply-templates> 

Instruction xsl :attribute 

<xsl :attribute 

name = { qname } 

namespace = { uri -reference }> 

<!-- Contenu : modele de transformation --> 

</xsl :attribute> 

Instruction de premier niveau xsl :attribute-set 

<xsl :attribute-set 
name = qname 

use-attribute-sets = qnames> 
<!-- Contenu : xsl :attribute*--> 
</xsl :attribute-set> 

Instruction xsl : call -tempi ate 

<xsl :call-template 
name = qname> 

<!-- Contenu : xsl :with-param*--> 
</xsl :call-template> 

Instruction xs1:choose 

<xsl :choose> 

<!-- Contenu : (xsl :when+, xsl lotherwise?) --> 
</xsl :choose> 

Instruction xsl: comment 

<xsl :comment> 

<!-- Contenu : modele de transformation --> 

</xsl :comment> 

Instruction xs1:copy 

<xsl :copy 

use-attribute-sets = qnames> 

<!-- Contenu : modele de transformation --> 

</xsl :copy> 
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Instruction xs1:copy-of 

|<xsl :copy-of 
select = expression /> 

Instruction de premier niveau xsl : decimal -format 

<xsl idecimal -format 
name = qname 

decimal -separator = char 
grouping-separator = char 
infinity = string 
minus-sign = char 
NaN = string 
percent = char 
per-mille = char 
zero-digit = char 
digit = char 

pattern-separator = char /> 

Instruction xs1:e1ement 

<xsl :el ement 

name = { qname ) 

namespace = { uri -reference } 

use-attribute-sets = qnames> 

<!-- Contenu : modele de transformation --> 
</xsl :el ement> 

Instruction xslrfallback 

|<xsl :fallback> 
<!-- Contenu : modele de transformation --> 
</xsl :fallback> 

Instruction xsl :for-each 

<xsl :for-each 

select = node-set-expression> 

<!-- Contenu : (xslisort*. modele de transformation) --> 
</xsl :for-each> 

Instruction xsl :if 

<xsl :if 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 
</xsl :if> 

Instruction de premier niveau xs1:import 

|<xsl : import 
href = uri -reference /> 
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Instruction de premier niveau xsl: include 

|<xsl : Include 
href = uri -reference /> 

Instruction de premier niveau xsl: key 

<xsl : key 

name = qname 
match = pattern 
use = expression /> 

Instruction xsl :message 

<xsl :message 

terminate = "yes" | "no"> 

<!-- Contenu : modele de transformation --> 
</xsl :message> 

Instruction de premier niveau xsl :namespace-a1ias 

<xsl :namespace-alias 

stylesheet-prefix = prefix | "#default" 
result-prefix = prefix | "#default" /> 

Instruction xs1:number 

<xsl :number 

level = "single" | "multiple" | "any" 

count = pattern 

from = pattern 

value = number-expression 

format = { string ) 

lang = { nmtoken ) 

letter-value = { "alphabetic" | "traditional" ) 
grouping-separator = ( char ) 
grouping-size = { number } /> 

Partie d'instruction xsl : otherwise 

<xsl :otherwise> 

<!-- Contenu : modele de transformation --> 

</xsl :otherwise> 

Instruction de premier niveau xs1:output 

<xsl routput 

method = "xml" | "html" | "text" | qname-but-not-ncname 
version = nmtoken 
encoding = string 

omit-xml-declaration = "yes" | "no" 
standalone = "yes" | "no" 
doctype-publ ic = string 
doctype-system = string 
cdata-section-elements = qnames 
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I indent = "yes" | "no" 
media-type = string /> 

Instruction de premier niveau ou partie d'instruction xsltparam 

<xsl iparam 

name = qname 

select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :param> 

Instruction de premier niveau xsl :preserve-space 

|<xsl :preserve-space 
elements = nametest-tokens /> 

Instruction xsl :processing-instruction 

<xsl iprocessing-instruction 
name = { ncname }> 

<!-- Contenu : modele de transformation --> 

</xsl :processing-instruction> 

Partie d'instruction xs1:sort 

<xsl :sort 

select = string-expression 
lang = { nmtoken } 

data-type = { "text" | "number" | qname-but-not-ncname} 

order = { "ascending" | "descending" } 
case-order = { "upper-first" | "lower-first" } /> 

Instruction de premier niveau xsl :strip-space 

|<xsl :strip-space 
elements = nametest-tokens /> 

Racine du document XSLT xsl : stylesheet 

<xsl :stylesheet 
id = id 

extension-element-prefixes = ncname-tokens 
excl ude-result-prefixes = ncname-tokens 
version = number> 

<!-- Contenu : (xsl : import*, Instructions de premier niveau) --> 
</xsl :stylesheet> 

Instruction de premier niveau xsl: tempi ate 

<xsl :templ ate 

match = pattern 
name = qname 
priority = number 
mode = qname> 

<!-- Contenu : (xsl iparam*, modele de transformation) --> 
</xsl :template> 
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Instruction xs1:text 

<xsl :text 

disable-output-escaping = "yes" | "no"> 
<!-- Contenu : #PCDATA --> 
</xsl :text> 



Racine du document XSLT xsl :transforin 

<xsl itransform 
id = id 

extension-element-prefixes = ncnaitie-tokens 
exclude-result-prefixes = ncname-tokens 
version = number> 

<!-- Contenu : (xsl : import*, top-level -elements) --> 
</xsl :transforni> 

Instruction xs1:va1ue-of 

<xsl :val ue-of 

select = string-expression 
disable-output-escaping = "yes" | "no" /> 

Instruction de premier niveau ou instruction xs1:variab1e 

<xsl :variable 
name = qname 
select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :variable> 

Partie d'instruction xsl : when 

<xsl :when 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 

</xsl :when> 

Partie d'instruction xsl :with-param 

<xsl :with-param 
name = qname 
select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :with-param> 



E 
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Fonctions XPath 



Note 

Cette annexe estune adaptation de la traduction frangaise de la Recommandation XPath 1.0 du 16 novembre 
1999, realisee parj ean-J acquesThomasson etYves Bazin. Elle estdisponible a I'adresse http://xmlfr.org/w3c/ 
TR/xpath. Les modifications consistent essentiellementen une homogeneisation de vocabulaire, de locutions et 
de tournures avec le reste du livre. Quelques remarques en marge du texte ont ete ajoutees ?aetla, poureclai- 
rerla comprehension. 

Cette section decrit les fonctions que les implementations de XPath doivent toujours 
incluredans leurs bibliothequesde fonctions utilisees pour I 'interpretation des expressions. 

Chaque fonction de la bibliotheque est specifiee en utilisant une fonction prototype, qui 
donneletype retourne, le nom de la fonction et le type des arguments. Si un typed'argu- 
ment est suivi d'un point d'interrogation, cela signifie que cet argument est optionnel ; 
sinon, I 'argument estrequis. 

Fonctions de manipulation de node-sets 
number lastO 

La fonction last retourne un nombre egal au nombre total de nceuds memorise dans le 
contexted'evaluation del 'expression (voir Contexted 'evaluation d'un predicat, page 57). 
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numder positionO 

La fonction position retourne un nombre egal a I'indice de proximite memorise dans le 
contexted'evaluation de ['expression (voir Contexte d 'evaluation d'un predicat, page 57), 

number counti node-set ) 

L a fonction count retourne le nombre de noeuds du node-set passe en argument. 
node-set id( object ) 

La fonction id selectionne les elements par leur identifiant unique. Quand I'argument 
de la fonction id est du type « node-set », alors le resultat est I 'ensemble des resultats de 
['application de la fonction id a la valeur textuel I e (string-value) dechacun des noeuds du 
node-set passe en argument. Quand I'argument de la fonction id est d'un autre type, 
celui-laestconverti en unechainedecaracterescommepar un appel a la fonction string. 
La chaine de caracteres est transformee en une sehe d'unites lexicales separees par des 
espaces blancs. Le resultat est un node-set contenant les elements du meme document 
que le noeud contexte et qui ont un identifiant unique egal a I'une quelconque des unites 
lexicales de la serie. 

• idC'truc") Selectionne I'element qui a comme identifiant unique true ; 

• id("truc")/child: :para[position()=5] Selectionne le Cinquieme enfant para de 

i'element qui a comme identifiant unique true. 
string local-name( node-set ? ) 

La fonction local-name retourne la partie locale du nom du noeud du node-set passe en 
argument qui est le premier dans I'ordre de lecture du document. Si le node-set passe 
en argument est vide ou que le premier noeud n'a pas de nom, la fonction retourne une 
chaine de caracteres vide. Si I'argument est omis, la valeur par defaut utilisee par la fonction 
est un node-set reduit au seul noeud contexte. 

string namespace-uri( node-set ? ) 

La fonction namespace-uri retourne I'URi correspondant au domaine nominal du noeud 
du node-set passe en argument qui est le premier dans I'ordre de lecture du document, Si 
le node-set passe en argument est vide, ou si le premier noeud n'a pas de nom, ou n'a pas 
de domaine nominal, une chaine vide est retournee. Si I'argument est omis, c'est comme 
si on avait transmis un node-set ne contenant que le noeud contexte. 

Note 

La chaine retournee par la fonction namespace-uri estvidesauf pour les noeuds detype element et attribute. 
String name( node-set ? ) 

La fonction name retourne une chaine contenant un nom qualifie representantlenom du 
noeud du node-set passe en argument qui est le premier dans I 'ordre de lecture du document. 
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Ce nom qualifie tient compte de la declaration du domaine nominal en vigueur sur le 
noeud en question. 

General ement, le nom retourne est le meme que le nom qualifie apparaissant dans le source 
XM L, Maisil peuty a voirdescasou lenom retourne n'emploie pas le meme prefixe que 
dans le source XM L ; meme dans ce cas, il reste encore certain que le domaine nominal 
associe a ce prefixe est le meme que celui declare pour le noeud considers dans le source 
XM L. Si lesourceXM L utilise plusieurs prefixes pour le meme domaine nominal, lafonc- 
tion name( ) peuttres bien normaliser la situation en n'en n'utilisantqu'un seul. 

Si le node-set passe en argument est vide ou que le premier noeud n'a pas de nom, une 
chaine vide est retournee. Si I 'argument est omis, c'est comme si on avait transmis un 
node- set ne contenant que le noeud contexte. 

Note 

La cha me retournee par la fonction nameestidentiqueacelle retournee par la fonction i ocai -name, excepte pour 
les noeuds de type el ement et attr1 bute. 

Fonctions manipulant des chatnes de caracteres 
string string( object ? ) 

La fonction string convertit un objet en chaine de caracteres selon les regies indiquees 
ci-dessous. 

U n node-set est converti en chaine de caracteres en retournant la valeur textuelle du pre- 
mier noeud du node-set dans I 'ordre de lecture du document. Si le node-set est vide, une 
chaine vide est retournee. 

U n nombre est converti en chaine comme suit : 

• N aN est converti en la chaine de caracteres NaN ; 

• lezero positif est converti en la chaine o (caracterezero) ; 

• le Zero negatif est converti en la chaine o (caractere zero) ; 

• I'infini positif est converti en la chaine Infinity ; 

• I'infini negatif est converti en la chaine -Infinity ; 

• si le nombre est un entier, 11 est represents sous forme decimale comme un nombre 
(Number) sans point decimal etsanschiffreapreslavirgule, preceded'un signemoins 
(-) si le nombre est negatif ; 

• sinon, le nombre est represents sous la forme d'un Nombre (Number) ayant toujours 
au moins un chiffre avant et apres le point decimal, precede du signe moins (-) si le 
nombre est negatif ; si le nombre est inferieur a 1 en valeur absolue, il n'y a qu'un seul 
0 avant le point decimal. Enfin, au dela du premier chiffre requis apres le point deci- 
mal, il doit y avoir le nombre de chiffres necessaire et suffisant pour differencier sans 
ambiguite le nombre de toutes les autres valeurs numeriques du standard IEEE 754, 
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L a valeur booleenne f ai se est convertie en la chatne de caracteres f ai se. L a valeur boo- 
leenne true est convertie en la chalne de caracteres true. 

Tout objet d'un type different des quatre types de base est converti en chalne de caracte- 
res selon une regie propre au type en question. 

Si I 'argument est omis, c'est comme si on avait transmis un node-set ne contenant que le 
nceud contexte, 

Note 

La fonction string( ) n'est pas faite pour formater des nombres en chaines de caracteres pour les besoins 
d'affichage ou de presentation aux utilisateurs. La fonction format-number et I'element xsi inumber de XSLT 
sontlapourga. 

String concat( string , string , string *) 

L a fonction concat retourne le resultat de la concatenation des arguments. 
booiean starts-with( string , string ) 

L a fonction starts-with retourne la valeur booleenne true si la premiere chalne de carac- 
teres passee en argument commence par la chaine de caracteres passee en deuxieme 
argument; sinon, cette fonction retourne la valeur false . 

booiean contains( string , string ) 

La fonction contains retourne true si la premiere chaine de caracteres passee en argu- 
ment contient la chaine de caracteres passee en deuxieme argument ; sinon, retourne la 
valeur false . 

string substring-before( string , string ) 

La fonction substring-before(sl,s2) retourne la sous-chalne de si qui precede la pre- 
miere occurrence des2 dans si, ou une chaine vide si si ne contient pas s2. Parexemple, 

substring-before( "1999/04/01" . "/" ) retOUrne 1999. 

String substring-after( string , string ) 

La fonction sub5tring-after(sl,s2) retourne la sous-chatne de si qui suit la premiere 
occurrence de s2 dans si, ou une chaine vide si le si ne contient pas s2. Par exemple, 

substring-afterC "1999/04/01","/") retOUrne 04/01, et substring-after( "1999/04/ 

01", "19") retourne 99/04/01. 

string substring! string , number , number ? ) 

La fonction substringCstr, indexDebut, Ig) retourne la sous-chatne de str commengant 

a la position indexDebut et de longueur Ig. Par exemple, substring("12345",2.3) 

retourne "234". Si le troisieme argument n'est pas specific, la fonction retourne la sous- 
chaine allant de la position de depart specifiee par indexDebut jusqu'a la fin de str. Par 
exemple, substring("i2345",2) retourne "2345". 
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Plus precisement, chaque caractere de la chatne a une position numehque : celle du pre- 
mier caractere est 1, celle du deuxiemeest 2, etc. 

Note 

Ceci differe dej ava etECMAScript, dans lesquels les methodes string. substring considerentque la position 
du premier caractere estO. 

L a sous-chaine retournee contient les caracteres dont la position est superieure ou egale a 
la valeur arrondie de indexoebut et (si le troisieme argument ig est specific) inferieure 
a la somme des valeurs arrondies de indexOebut et ig ; les comparaisons et I'addition 
uti 11 Sees ci-dessus doi vent suivre les regies du standard IEEE 754; I'arrondi estcalcule 
comme par un appel a la fonction round. 

Les exemples suivants illustrent differents cas de figures courants : 

• substring("12345" . 1.5. 2.6) retOUrne "234" ; 

• substring("12345" . 0, 3) retOUme "12" ; 

• substring("12345" . 0 div 0, 3)retOUrne"" ; 

• substring("12345". 1, 0 div OretOUme"" ; 

• substring("12345". -42. 1 div 0) retOUme "12345" ; 

• substring("12345". -1 div 0. 1 div 0) retOUme "". 

number string-length( string ? ) 

La fonction string-length retourne le nombre de caracteres de la chatne. Si I'argument 
est omis, la valeur retournee est egale a la longueur de la valeur textuelle du noeud 
contexte. 

string normalize-space( string?) 

La fonction normalizespace retourne la chaine de caracteres passee en argument apres 
y avoir normalise les espaces blancs : suppression des espaces blancs en debut et fin et 
remplacement des sequences d'espaces blancs successifs par un seul caractere blanc. 
Si I'argument est omis, la fonction retourne la chaine obtenue en ayant utilise comme 
argument la valeur textuelle du noeud contexte. 

string translate( string , string , string ) 

L a fonction translate retourne la premiere chaine de caracteres passee en argument dans 
laquelle les occurrences des caracteres de la deuxieme chaine sont remplacees par les 
caracteres correspondant aux memes positions de la troisieme chaine. Par exemple, 
transiate("bar","abc"."ABC") retoume la chaine BAr . Si I'un des caracteres du 
deuxieme argument n'a pas de position correspondante dans le troisieme (parce que 
le deuxieme argument est plus long que le troisieme), alors les occurrences de ce carac- 
tere sont supprimees du premier argument. Par exemple, transiate("--aaa--" . "abc-" , 
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"ABC") retoume "AAA". Si un caractere apparait plus d'unefois dans la deuxiemechaine, 
alors c'est la premiere occurrence de ce caractere qui determine la regie de transforma- 
tion. Si la chaine passee en troisieme argument est plus longue que la deuxieme, alors, les 
caracteres en trop sont ignores. 

Note 

La fonction translate n'est pas suffisante pour les changements de casse dans toutes les langues. Une future 
version de XPath fournira des fonctions additionnelles a cette fin. 



Fonctions Booleennes 

boolean boolean( object ) 

La fonction boolean convertit ses arguments en booleens selon les regies suivantes : 

• un nombreestvrai (true) si et seulement s'il n'est ni un zero positif ou negatif, ni un 
NaN ; 

• un node-set est vrai (true) si et seulement s'il n'est pas vide; 

• une chainede caracteres est vraie (true) si et seulement si sa longueur n'est pas nulle; 

Un objet d'un type autre que les quatre types de base est converti selon des regies speci- 
fiques a chaque type. 

boolean not( boolean ) 

La fonction not retoume la negation logique de la valeur du booleen passe en argument : 
vrai (true) si I 'argument est faux et vice-versa. 

boolean trueO 

La fonction trueO retourne true. 
boolean falseO 

La fonction falseO retourne false, 
boolean lang( string ) 

La fonction lang retourne true si et seulement si la langue associee au noeud contexte 
correspond a la langue passee en argument de la fonction, ou en est une variante locale. 

La langue du noeud contexte est determi nee par la valeur de I'attribut xmi :iang du noeud 
contexte, ou, si celui-ci n'a pas cet attribut, par la valeur de I'attribut xml : 1 ang du plus 
proche ancetre du noeud contexte ayant cet attribut. Si aucun n'est trouve, la fonction 
lang retourne la valeur false. Si un tel attribut existe, alors la fonction lang retourne la 
valeur true si la valeur de I'attribut estegale a celle passee en argument (les differences 
de casse etantignorees), ou s'il existeun certain suffixecommengantpar - desorteque la 
valeur de I'attribut soit egale a I 'argument si on ignore ce suffixe et la casse. Par exemple. 
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1 ang( "en ") retourne la valeur true si le noeud contexte est I'un des quatre elements 
<para> suivants : 

• <para xml : 1 ang="en"/> ; 

• <div xml : 1 ang="en"><para/></di v> ; 

• <para xml : 1 ang="EN"/> ; 

• <para xml : 1 ang="en-us"/>. 

Fonctions numeriques 

number number( object ? ) 

La fonction number convertit en nombre son argument passe selon les regies indiquees 
ci-dessous. 

• Une chaine de caracteres qui est composee d'espaces blancs (optionnels) suivis du 
signemoins (-) suivi d'un nombre (Number) suivi d'espaces blancs est convertie en un 
nombre le plus proche possible (selon la regie d'arrondi au plus proche de I'lEEE 754) 
du nombre IEEE 754 le plus proche possible de la valeur mathematique exacte repre- 
sentee par la chaine ; toute autre chaine est convertie en NaN . 

• Les booleens vrais ( true ) sont convertis en 1 ; les booleens faux ( false ) sont 
convert! s en 0. 

• U n node-set est d'abord converti en chaine de caracteres comme par I 'effet d'un appel 
a la fonction string et cette chaine est ensuite consideree comme argument de la fonc- 
tion number. 

• Un objetde type different des quatre types debase est converti en un nombre selon des 
regies dependantes du type de I 'objet. 

Si I'argument est omis, la valeur retournee par defaut est celle qui auraitete obtenue en 
considerant un node-set contenant le seul noeud contexte. 

Note 

La fonction number ne doit pas etre utilisee pour convertir des donnees numeriques se b'ouvant dans un 
elementd'un document XM L sauf si I'elementen question estd'un type permettantde representerdes donnees 
numeriques dans un format neuti'e (qui serait typiquement b'ansforme dans un format specifique pour eti'e 
presentees a un utilisateur). De plus, la fonction number ne peut eti'e utilisee que si le format neutre utilise par 
I'element est coherent avec la syntaxe XPatti definie pour les nombres (Number). 

_ _ J 

number sum[ node-set ) 

La fonction sum retourne la somme, pourtous les noeudsdu node-set passe en argument, 
des resultats de la conversion en nombre des valeurs textuelles (string-values) dechacun 
deces noeuds. 
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number 1\oor( number) 

La fonction floor retourne le plus grand (du cote de I'infini positif) nombre entier infe- 
rieur a ['argument. 

number ceiling( number) 

La fonction ceiling retourne le plus petit (du c6te de I'infini negatif) nombre entier qui ne 
soit pas inferieur a I 'argument, 

number round( number ) 

Lafonction arrondi ( round ) retourne le nombre entier le plus prochedel'argument. S'il 
y a deux nombres possibles, alors celui des deux qui est le plus proche de I'infini positif 
est retourne. Si I'argument est NaN, alors NaN est retourne. Si I'argument est I'infini 
positif, alors I'infini positif est retourne. Si I'argument est I'infini negatif, alors I'infini 
negatif est retourne. Si I'argument est lezero positif, alors lezero positif est retourne. Si 
I'argument est le zero negatif, alors le zero negatif est retourne. Si I'argument est infe- 
rieur a Zero, mais plus superieur ou egal a -0.5, alors lezero negatif est retourne. 

Note 

Pourles deux derniers cas, le resultatde I'appelde la fonction tx)und nedonne pas le meme resultatqu'en addi- 
tionnantO.5 au resultatde la fonction floor. 

Fonctions XSLT 

Fonctions de manipulation de node-sets 
node-set document( object , node-set ? ) 

Lafonction documento permet d'acceder aux documents XML autres que le document 
source principal. 

Lorsque la fonction document( ) a exactement un argument et que cet argument est un 
node-set alors, le resultat est I'union, pour chaque noeud du node-set regu en argument, 
du resultat de I'execution de la fonction documento avec comme premier argument la 
valeur textuelle du noeud, et comme deuxieme argument un node-set dont I 'unique ele- 
ment est le noeud lui-meme. Lorsque la fonction documentc ) a deux arguments et que le 
premier argument est un node-set, alors le resultat est la reunion, pour chaque noeud du 
node-set regu en argument, du resultat de I'execution de la fonction documento avec 
comme premier argument la valeur textuelle du noeud et, comme deuxieme argument, le 
deuxieme argument passe a la fonction documento. 

Si le premier argument de la fonction document n'est pas un node-set alors il sera 
converti en une chaine de caracteres comme par appel a la fonction stringo. Cette 
chaine de caracteres est traitee comme une reference a un URI ; la ressource identifiee 
par I'URI est extraite. Les donnees resultant de la fonction d'extraction sont analysees 
comme un document XM L et un arbre est construit en concordance avec le modele de 
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donnees (voir Module arborescent d'un document XML vu par XPath, page 30). Si 
I 'extraction de la ressource se solde par une erreur, alors le processeur X SLT peut signa- 
ler I'erreur ; s'il ne lefait pas, 11 doit retourner un node-set vide. Le genre d'erreur pou- 
vant se produire a I 'extraction, serait que le processeur X SLT ne connaisse pas la syntaxe 
utilisee pour I'URI. Un processeur XSLT n'est pas cense connaitre toutes les syntaxes 
particulieres d'URI. Les syntaxes d'UR I acceptees par un processeur XSLT doiventetre 
clairement indiquees dans sa documentation. 

En marge de ce texte 

Un identificateur de fragment est un identificateur qui designe une partie d'une ressource. Par ex., pourl'URL 
http://www.truc.0rg/index.ht11nl#ici, I'identificateur de fragment est i ci . 

Si la reference a I'URI ne contient pas d'identificateur de fragment, alors la fonction 
retourne le node-set contenant uniquement le noeud racine du document. Si la reference a 
I'URI contient un identificateur de fragment, alors la fonction retourne un node-set 
contenant I es noeuds de I ' arbre i denti fies par I ' i denti ficateur de fragment de I a reference a 
I'URI. La semantique de I'identificateur de fragment depend du type de media (type 
MIME) du resultat de I'extraction de I'URI. Si lors du traitement de I'identificateur de 
fragment, une erreur se produit, le processeur XSLT peut signaler cette erreur, ou bien 
retourner un ensemble vide de noeuds. Exemples d'erreurs possibles : 

• L'identificateur du fragment fait reference a quelque chose qui ne peut etre represents 
parun node-set XSLT (comme une sous-chalne de caracteres a I'interieur d'un noeud 
texte). 

• Le processeur XSLT ne connait pas la fagon de traiter les i denti ficateurs de fragment 
pour letypeM IM E du resultat de la recuperation. Un processeur XSLT n'est pas sup- 
pose pouvoir traiter tous les types MIME parti cullers. La documentation de chaque 
processeur X SLT doit indiquer quels sont les types MIME acceptes pour I e traitement 
des i denti ficateurs de fragments. 

L es donnees resultant de Taction d'extraction sont analysees comme tout autre document 
XML sanstenir comptedu typeM IM E du resultat de I'extraction ; si letypeM IM E prin- 
cipal est text, alors 11 est analyse comme si le type MIME etait text/xml ; autrement, 11 
est analyse comme si letypeMIME etait application/xml, 

Note 

Puisqu'il n'y a pas de type |V|||V|E principal xml, les donnees avec un type MIME autre que text/xml ou appii- 
cation/xmi peuventtres bien etre quand meme des donnees XML. 

La reference a I'URI peut etre relative. L'URI de base (voir Remarque ci-dessous) du 
noeud qui apparaitle premier dans le document et qui appartientau node-set du deuxieme 
argument est utilise comme U Rl de base pour resoudre les U Rl relatifs et les transformer 
enURI absolus. Lorsque le deuxieme argument est omis, il est par defaut egal al'element 
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XSLT (lenoeud del'arbreX M L du programme XSLT) qui contient ('expression ou figure 
I'appel a la fonction document o, Notez qu'une reference a un URI de tai lie null e est une 
reference au document dont I'URI qui lui est relatif est en cours de resolution ; ainsi 
documentc) fait reference au noeud racine de la feuille de style elle-meme; I'arbre 
XML delafeuilledestyleestexactementlememequecelui qu'on obtiendraiten prenant 
cette feuille de style comme document source initial. 

URI de base (remarque en marge de ce texte) 

A chaque nceud est associe un URI qu'on appelle son URI de base, qui est utilise pour resoudre des valeurs 
d'attributs qui represententdes URI relatifs (c'est-a-dire pour determiner I'URI absolu connaissant I'URI relatif), 
suivant un principe identique a celui de la construction d'un chemin absolu designant un fichier, connaissant un 
chemin relatif etun repertoire de base qui sertde reference pour revaluation du chemin relatif), Si un elementou 
une processing-instruction apparaitdans une entite externe, alors son URI de base est I'URI de I'entite externe ; 
autrement, I'URI de base estl'URI de base du document L'URI de base du noeud racine de I'arbre XML estl'URI 
de I'entite document L'URI de base d'un nceud text, d'un noeud comment, d'un nceud attribute ou d'un noeud 
name-space estl'URI de base de son nceud parent 

Prenons parexemple I'instruction <xsi : include href=". . ."/> d'une certaine feuille de style que I'on suppose 
ecrite d'un seul tenant (pas d'entite externe), L'URI de base de cette instruction est done I'URI de base de la 
feuille de style elle-meme, qui n'est autre que le repertoire qui la contient Si done I'URI indique dans I'attribut 
href est un URI relatif, 11 sera alors resolu par rapport ace repertoire. 

Deux documents sont consideres comme n'en faisant qu'un s'ils sont identifies par le 
meme URI. L'URI utilise pour la comparaison est I'URI absolu pour lequel chaque URI 
relatif a ete resolu et ne contient aucun identificateur de fragment. Les noeuds racine de 
deux documents identifies par le meme URI sont consideres comme indiscernables. 
Ainsi, I'expression suivanteesttoujoursvraie : 

I generate-id(docuinent( "trucxml " ) )=generate-id (document ( "truc.xml " ) ) 

Avec la fonction documento, s'ouvre la possibilite qu'un node-set puisse contenir des 
noeuds provenant de plusieurs documents differents. Dans un tel node-set, I'ordrede lec- 
ture du document applicable a deux noeuds provenant du meme document est I 'ordre nor- 
mal de lecture du document defini par X Path. L'ordrede lecture du document applicable 
a deux noeuds provenant de deux documents differents est determine par I 'implementa- 
tion. La seule contrainte est que I'implementation doit etre coherente avec elle-meme : 
un meme ensemble de documents doit toujours produire le meme ordre. 

node-set key( string , object ) 

La fonction keyo joue le meme role pour les cles que celui de la fonction ido pour les 
I D s. L e premi er argument sped fie I e nom de I a cle. L a val eur de cet argument doit etre un 
QName (nom qualifie). Lorsque le type du deuxieme argument de la fonction key( ) est 
un node-set, alors le resultat est la reunion des resultats de I 'application de la fonction 
key( ) a la valeur de la chalne de caracteres de chacun des noeuds du node-set re^u en 
deuxieme argument par la fonction. Si le type du deuxieme argument de la fonction 
keyo n'est pas le type node-set, alors I'argument est convert! en une chainede caracteres 
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commeparappel alafonction stringo ; elleretourneun node-set contenantdesnoeuds 
du meme document que celui auquel appartient le noeud contexte. Ces noeuds sont ceux 
qui ont une valeur pour cette cle nommee, et pour lesquels cette valeur est egale a cette 
chaine de caracteres. 

Etantdonne, parexemple, la declaration suivante : 

I <xsl:key nanie="iclkey" match="cliv" use="@id"/> 

I'expression key("idkey".@ref) retoume le meme ensemble de noeuds que id(@ref), a 
condition que leseul attributID declare dans le document sourceXM L soit: 

<!ATTLIST div id ID #IMPLIED> 

et que I'attribut ref du noeud courant necontienne pas d'espace blanc. 

Considerons un document decrivant une bibliotheque de fonctions et utilisant un element 
prototype pour definir les fonctions : 

<prototype naine="key" return-type="node-set"><br> 
<arg type="string"/><br> 
<arg type="object"/><br> 
</prototype> 

ainsi qu'un element function pour fai re reference aux noms des fonctions : 

I <function>key</function> 

La feuille de style peut alors generer des hyperliens entre les references et les definitions 
commesuit : 

<xsl:key name="func" inatch="prototype" use="@name"/> 

<xsl itemplate niatch="function"><br> 
<b> 

<a href ="#{generate-id( key ( 'func' ,.)))"> 
<xsl :apply-teinplates/> 

</a> 

</b> 

</xsl itempl ate> 

<xsl itemplate match="prototype"> 
<P> 

<a name="{generate-id( )}"> 
<b> Function: </b> 

</a> 

</p> 

</xsl itempl ate> 

La fonction keyc ) peut etre utilisee pour recuperer une cle a partir d'un document autre 
que le document contenant le noeud contexte. Supposons par exemple que nous ayons un 
document contenant des references bi bliographiques sous la forme <bi bref >xsLT</bi bref >, 
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et qu'il y ait un document XM L separe bib.xmi contenant la base de donnees bibliogra- 
phiques, avec des entrees de la forme : 

<entry naine="XSLT">. . .</entry> 

Mors, pour la transformation des elements bi bref la feuille de style peut contenir ce qui 
suit : 

<xsl:key name="bib" inatch="entry" use="@name"/> 

<xsl itempl ate match="bibref "> 

<xsl ivariable naine="name" select="."/> 

<xsl :for-each select="document( 'bib.xmi ' )"> 

<xsl :apply-templates select="key( 'bib' ,$name)"/> 

</xsl :for-each> 
</xsl itempl ate> 

String generate-id( node-set ) 

L a fonction generate-i dc ) retoume une chaine de caracteres qui identifie d'une maniere 
unique le noeud dans le node-set requ en argument, qui est le premier noeud dans I'ordre 
de lecture du document. L'identificateur unique doit etre compose de caracteres ASCII 
alphanumehques et doit commencer par un caractere alphabetique. C'est done un nom 
XML syntaxiquement correct. Une implementation est libre de generer un identificateur 
de la fagon qui lui est la plus appropriee, a condition que plusieurs generations successi- 
ves pour un meme noeud donnenttoujours le meme identificateur, et que deux noeuds dis- 
tincts donnent toujours des identificateurs distincts. Une implementation n'est pas 
obligee de generer les memes identificateurs chaquefoisqu'un document subi une trans- 
formation. Rien ne garanti qu'un identificateur genere sera necessairement distinct de 
tous les IDs uniques specifies dans le document source. Si le node-set re^u en argument 
est vide, la fonction retourne la chaine de caracteres vide. Si I'argument est omis, le 
noeud contexte est pris par defaut comme argument. 

Note 

La suite de cette section consacree a la fonction generate-ido ne fait plus partie de la traduction. 

Cette fonction a ete largement commentee, notamment dans le chapitre sur les Patterns 
de transformation, Une application inattendue est celle qui consiste a contourner certai- 
nes interdictions syntaxiques dans les motifs associes a une regie de transformation. On 
salt qu'un motif est une expression XPath bridee (voir Syntaxe et contrainte pour un 
motif XSLT, page 98). Un jour, sur la liste de discussion XSLT de mulberrytech (xsl- 
list@lists.mulberrytech.com dont I 'archive est consultable sur www.biglist.com/lists/xsl-list/ 
archives), quelqu'un a demande comment ecrire un motif qui Concorde avec le premier 
noeud texte descendant d'un element quelconque, disons <item> (faire eventuellement 
une recherche sur Google avec « [xsl] Selecting first descendant text node»). II regut 
trois reponses, une erronee et deux correctes. La reponse erronee etait celle-ci : match= 
" ( i tem//text( ))[!]". Ce motif est incorrect parce qu'il est interdit de regrouper certains 
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elements d'un motif avec des parentheses. Par centre, c'est une expression XPath cor- 
recte, etqui exprimebien I'ideesouliaitee. 

L'une des deux reponses correctes, envoyee par M iciiael Kay, etait celle-ci : 

I text()[ generate-id( ) = generate-id( ( ancestor: :itein//text( ) )[1] ) ] 

L'idee est ici de contourner ['interdiction en plagant a I'interieur du predicat les clioses 
interdites, car un motif n'impose aucune contrainte particuliere aux eventuels predicats 
utilises. Done, ici, on va dire que le motif doit concorder avec n'importe quel texte, 
pourvu que... 

Le « pourvu que ... » reprend tout simplement I'expression XPath de la fausse bonne 
reponse (item//text())[i], en I'amenageant un peu. En effet, on peutdire, commeLa 
Palice, que tout texte convient, pourvu qu'il soitle premier descendant d'un <item>, puis- 
que c'etait precisement cela la question. Comme on a un test d'identite a effectuer (ce 
texte est-il lememequetel autre?), lafonction generate-id( ) est done mise a contribu- 
tion. Etant donne un noeud texteT, la question devient : ce noeud texte est-il le memeque 
eel ui represents par I'expression ( ancestor: :item//text( ) )[i] eval uee avec T comme 
noeud contexte ? Cette expression represente I e premier noeud texte descendant d'un ele- 
ment item qui est un ancetre de T. Done finalement, le motif se lit : tout noeud texteT, 
pourvu qu'il soit le meme que le premier noeud texte descendant d'un element item qui 
est un ancetre del. 

Inutile de dire qu'une telle recherche de concordance peut etre assez couteuse en temps 
de calcul ; c'est pourquoi la conclusion de M ichael K ay fut qu'il etait probablement pre- 
ferable de repenser le probleme pour eviter d'avoir une regie avec un motif aussi etrange. 

string unparsed-entity-uri( string ) 

Lafonction unparsed-entity-uri o retourneTUR! del'entite (non analyseeparun par- 
seur XM L) dont le nom est sped fie par la string fournieen argument, et declaree dans la 
DTD du document dont le noeud contexte est issu. Si une telle entite n'existe pas, alors 
la fonction retourne une chaine de caracteres vide. 

node-sef currentO 

La fonction currento retoume un node-set ayant pour seul element le noeud courant. 
Pour une expression dont I 'evaluation ne depend pas d'une autre expression, le noeud 
courant se confond toujours avec le noeud contexte. A insi, 

I <xsl :val ue-of select="current( )"/> 

a la meme signification que : 

i <xsl :val ue-of select="."/> 

Cependant dans des crochets (i.e. dans un predicat), le noeud courant est habituellement 
different du noeud contexte. Par exemple. 



I <xsl : apply- tempi ates sel ect="//gl ossary/item[@name=current( )/@ref ]"/> 



H Reference des fonctions predefinies 

va traiter tous les elements i tem qui ont un element gi ossary parent et qui ont un attribut 
name dont la valeur estegalea la valeur de I 'attribut ref du noeud courant. Ceci est diffe- 
rent de 

I <xsl :apply-templates select="//glossary/itein[@name=./@ref]"/> 

qui signifie la meme chose que : 

<xsl :apply-templates select="//glossary/itein[@name=@ref]"/> 

permettant de traiter tous les elements item ayant un element gi ossary parent et ayant un 
attribut name et un attribut ref qui setrouvent avoir la meme valeur. 

L'utilisation de la fonction current ( ) dans un motif est une erreur. 

Formatage de nombres 

string format-number( number, string , string ) 

La fonction fo rmat-num bero convertit un nombre en une chaine de caracteres. Le pre- 
mier argument est le nombre a convertir ; le deuxieme est un motif sped fiant I e format de 
conversion ; letroisieme argument representeleformat decimal (en son absence, il y a un 
format decimal par defaut). La chalne de caracteres constituant le motif de conversion 
doit respecter la syntaxe specifiee par la classe Decimal Format du J DK 1.1 (Kit de deve- 
loppement Java de Sun Microsystems). Le motif de specification de format est une 
chainelocalisee(i.e. susceptible de subir des variations propres a la langueetaux coutu- 
mes culturelles du pays de I'utilisateur) : le format decimal determine quels sont les 
caracteres ayant une signification particuliere dans le motif (a I'exception du guillemet 
qui n'est pas localise). Le motif de format ne doit pas contenir le symbole de la devise 
monetaire(*<00A4) ; le support de cette caracteri sti que a ete ajoute apres la livraison ini- 
tiale du JDK 1.1. Le nom du format decimal doit etre un QName (nom qualifie). La 
feuille de style doit contenir une declaration du format decimal avec ce nom qualifie, 
sinon c'est une erreur. 

Note 

Les implemenlBtions ne doivent pas forcement utiliser I'implementation du J DK 1.1, ni etre forcementrealisees 
en Java. 

Note 

Rien n'empeche les feuilles de style d'utiliser d'autres moyens disponibles dans XPath pour controler I'arrondi 
des nombres. 
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Fonctions diverses 

od/ecf system-propertyC string ) 

L'argument de cette fonction doit etre une chaine de caracteres representant un QName 
(nom qualifie). Le QName est evalue en utilisant la declaration de domaine nominal en 
vigueur pour I'expression en cours. La fonction system-propertyc ) retourne un objet 
representant la valeur de la propriete systeme identifiee par le nom. Si une telle propriete 
systeme n'existe pas alors la chaine de caracteres vide est retournee. 

Les implementations doivent fournir les proprietes systeme suivantes qui sont toutes 
dans le domaine nominal XSLT : 

• xsi :version, C'est un nombre qui indique la version de XSLT supportee par le pro- 
cesseur; Cette valeur est 1.0 pour les processeurs XSLT implementant la version de 
XSLT sped fiee dans ce document. 

• xsl : ven dor. C'est une chaine de caracteres identifiant le fabriquant du processeur 
XSLT. 

• xsl : vendor-ur 1. C'est une chaine de caracteres qui contient une URL identifiant le 
fabricant du processeur XSLT ; typiquement, cette URL est la page d'accueil (home 
page) du site Web du fabriquant. 

booleen element-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion eiement-avaiiabie( ) retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une instruction. Si le nom obtenu est dans le domaine nominal de XSLT, alors 11 
reference un element defini par XSLT. Sinon, 11 reference une extension. Si le domaine 
nominal du nom estnul, lafonction eiement-avaiiabieo retourne la valeur faux. 

booleen function-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion function-avaiiabieo retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une fonction de la bibliotheque. 

Si le nom obtenu est dans le domaine nominal nul, alors il reference une fonction prede- 
finie par XPath/XSLT ; sinon, il reference une extension. 
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Axe de localisation. En anglais Axis. Point de depart d'une etape de localisation. Etant 
donne un noeud contexts, donne les noeuds qui partagent entre eux une meme relation de 
parente vis-a-vis de ce noeud contexte (parent, enfant, frere, descendant, etc.). Un axe 
de localisation peut etre direct ou retrograde, suivant qu'il contient de noeuds qui sont 
situes apresou avantle noeud contexte, lorsqu'on suit I'ordrede lecture du document. 

Axis. VoirAxe de localisation. 

Attribute ValueTemplate. Voir Descripteur de valeur differee d'attribut, 
BaseURI.VoirURI debase. 

Chemin de localisation. En anglais Location Path. Variante restrictive d'expression 
XPath capable de selectionner un node-set constitue de noeuds preleves dans un docu- 
ment source X M L et possedant tous une meme propriete expri mee par le chemi n de loca- 
lisation sous la forme d'une suite d'etapes de localisation. 

ContextNode. Voir Nffud contexte. 

C urrent Node. Voir Nffud courant. 

Descripteur de valeur differeed'attribut. En anglais Attribute Value Template (AVT), 
C'est une forme syntaxique speciale decrivant une valeur d'attribut sous la forme d'une 
expression X Path entre accolades. 

Vis avis decette propriete, on peut classer les attributsen trois categories : ceux dont les 
valeurs sont to uj ours evaluees statiquement (ou litteralement), ceux dont les valeurs sont 
toujours interpretees dynamiquement, etceux dont les valeurs acceptees sont en principe 
litterales, mais qui admettent exceptionnellement que la valeur fournie soit interpretee 
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dynamiquement, a condition qu'elle prenne la forme d'un descripteur de valeur differee 
d'attribut. 

Determinant. En anglais Node Test. Premier filtre qui determine les noeuds interessants 
d'un axe de localisation, dans I 'expression d'uneetapede localisation. 

Domaine nominal. En anglais Namespace. Un vocabulaire de nomsXML a qui I'on 
donneun nom qui prend generalementlaformed'uneURL. On trouve parfois la traduc- 
tion espace de noms. 

Distribution selective. En anglais Push processing. Traitement partiel d'un element 
suivi d'une remise de ses constituants dans la pile des elements a traiter En XSLT, I 'ins- 
truction <xsi :appiy-tempi ates> est typique de cette categorie de traitement. 

E lement source litteral. En anglais Litteral Result Element. Element X M L en dehors du 
domaine nominal deXSLT (et des extensions eventuellement utilisees) ; lecontenu d'un 
tel element XML est un modele de transformation, litteral ou non. Un element source 
litteral peut constituer en lui-memeun modele de transformation, litteral ou non. 

Etapede localisation. En anglais Step Location. Variante restrictive d'expression X Path 
qui fournit une etape dans la construction d'un chemin de localisation. One etape filtre 
les noeuds selectionnes par I 'etape precedente. 

E space blanc. En anglais Whitespace. Caractere d'espacement (espace, tabulation, saut 
de ligne, retour chariot). 

Extraction individuelle. En anglais Pull processing. Traitement qui consiste a extraire 
une information connaissant I'endroit ou elle se trouve. En XSLT, I'instruction 
<xsi :vaiue-of> est typique de cette categoMe. 

Grouping. Voir Regroupement, 

Indicedeproximite. En anglais Proximity position. Numero d'ordred'un noeud au sein 
d'un axe de localisation relatif a un noeud contexte. Pour un axe direct, les indices de 
proximite augmentent quand on s'eloigne du noeud contexte en suivant I 'ordre de lecture 
du document, alors que pour un axe retrograde, les indices de proximite augmentent 
quand on s'eloigne du noeud contexte dans I'ordre inverse de lecture du document. 

Lexeme. En anglais tol<en. Plus petite suite decaracteres reconnuecommeformantquel- 
que chose digned'interet par un analyseur. Dans I e contexte d'XSLT, la notion de lexeme 
intervient pour lafonction d'extension Xalan ou Saxon tokenizec ), qui decode la chaine 
de caracteres fournie, comme une suite de lexemes separes (par defaut) par des espaces 
blancs. 

Litteral Result Element. Voir Element Source Litteral. 
Location Path. Voir Chemin de localisation . 
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Modelede transformation. En anglais template. C'est le fragment de document XM L 
associe a une instruction, qui decrit lecontenu decette instruction. 

Modelede transformation litteral. C'est un modele de transformation qui ne contient 
que du texte, ou des elements XM L en dehors du domaine nominal de XSLT (et des 
extensions eventuel I ement uti I i Sees) ; un tel element XML est un element source litteral 
(Litteral Result Element), 

jviodelenomme. En anglais named template. A la meme forme qu'une regie de transfor- 
mation, mais possede un attribut name (a la place de I'attribut match) qui permet de 
I'appeler explicitement. 

Motif. En anglais pattern. Variante restrictive d'expression XPath utilisee principale- 
ment pour specifier (par le truchement de son attribut match) sur quels noeuds telle regie 
de transformation doits'appliquer. 

Named template. Voir M odele nomme. 

Namespace. Voir Domaine nominal. 

Node-set. Type predefini de XPath, qui representeun ensemble de noeuds au sensmathe- 
matique du terme (pas d'ordre, pas de doublon). Pas d'equivalent fran§ais dans ce livre, 
car N ode-set est un nom de type, considere comme un nom propre. 

NodeTest. Voir Determinant, 

Noeud contexte. En anglais Context Node. Noeud par rapport auquel on evalue une 
expression XPath. 

Noeud courant. En anglais Current Node. Noeud en cours de traitement. 

Pattern. Voir Motif. Dans ce livre, le mot pattern est aussi utilise au sens de pattern 
design (mise en evidence d'un type de problemeet d'unefagon deraisonner ou d'organi- 
ser son programme pour le resoudre de fa§on genehque). 

Pattern Matching. Voir Recherche de concordance de motif. 

Predicat. En anglais Predicat. Expression XPath quelconque, qui, lorsqu'elle est appli- 
quee a un node-set et convertie en booleen, fournit un critere d'acceptation ou de rejet 
pour constituer un nouveau node-set moins peuple. 

Predicat. Voir Pre'dicat. 

Prefix. Voir Pre/zxe. 

Prefixe. En anglais Prefix. Abreviation d'un domaine nominal placee devant un nom 
d'element ou d'attribut XML. 

Proximity position. Voir Indice de proximite'. 
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Pull processing. Voir Extraction individuelle. 
Push processing. Voir Distribution selective. 

Recherche de concordance de motif. En anglais Pattern Matching. Processus de 
recherche d'une regie dontle motif (voircemot) concordeavec lenoeud en coursdetrai- 
tement. 

Regie de transformation. En angiais template ruie. Definit une transformation eiemen- 
taire. Une regie de transformation est selection nee si son attribut match contientun motif 
qui Concorde avec le nceud en cours de traitement. 

Regie nommee. Pas de terme anglais consacre. Construction hybride, a la fois modele 
nomme (possedeun attribut name) et regie de transformation (possedeun attribut match). 

Regroupement. En anglais Grouping. Traitement au cours duquel des elements epar- 
pilles 9a et la dans le document source XML sont regroupes dans le document resultat en 
fonction d'une propriete commune. Ce genre de traitement est celebre pour etre coriace a 
programmer en XSLT 1.0 ; mais pour calmer la foule en colere, le groupe de travail 
XSLT 2.0 du W3C a propose une nouvelle instruction qui devraitsimplifier considerable- 
ment la programmation. 

Step Location. Voir E tape de localisation. 

Template. Voir M odele de transformation. 

Templaterule. Voir Regie de transformation. 

Temporary SourceTree. A breviation TST. Arbre XML qui resulte de I'instanciation 
d'un modele de transformation propre a une declaration de variable. Cet arbre peut 
constituer une source XML secondaire, car on peut I'explorer avec une expression 
XPath, soit directement (XSLT 1.1 ou 2.0), soit apres conversion en node-set a I 'aide 
d'une fonction de conversion fournie en tant qu'extension par le processeur utilise 
(XSLT 1.0). 

Ce terme n'est pas officiel. II est derive de la proposition de M ichael Kay, Temporary 
Tree, et reprise dans le premier Worl<ing Draft XSLT 2.0 du W3C. 

Token. Voir lexeme. 

URI (Uniform Resource Identifier). Terme generique, qui designe a la fois les URL 
(Uniform Resource Locator) et les URN (Uniform Resource Name). Dans ce livre, on 
peut dire que URI etURL sont equivalents. 

URI debase. En anglais Base U Rl . URI par rapport auquel on determine un URI relatif. 
Whitespace. Voir E space blanc. 
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Livres 

II y a essentiellement deux livres queje pourrais recommander : 

• M ichael Kay, XSLT Programmers Reference 2nd Edition, 2001, Wrox Press. 

• Jeni Tennison, XSLT and XPath On the Edge, 2001, Hungry M inds. 

Le livre de M ichael Kay est un ouvrage de reference extremement complet sur le Ian- 
gage, ecri t par I ' auteur de Saxon, I ' un des processeurs X SLT I es pi us connus. C ' est done 
une vision de I'interieur que nous apporte M ichael Kay. II offre la particularite d'etre 
structure commeun dictionnaire, cequi estclairementun avantage pour I 'utilisation cou- 
rante du developpeur averti, mais un inconvenient pour le debutant qui cherche a com- 
prendre. 

Celui dejeni Tennison est a reserver aux utilisateurs confirmes, dans la mesure ou les 
langages X SLT et X Path sont censes etre connus du lecteur, au moins dans les grandes 
lignes. Le livre explore un grand nombre de problemes, et commente les diverses solu- 
tions envisageables. 

Ressources Internet 

En dehors de ces deux livres, on trouve beaucoup de ressources sur Internet. En premier 
lieu, leW3C (XSLT du producteur au consommateur) : 

• www.w3.org/style/xSL : le point de depart pour tous les documents du W 3C concernant 
XPath et XSLT ; beaucoup de liens interessants. 
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Des sites d'extensions ou decomposantsXSLT reutilisables : 

• http://xslt5l.sourceforge.net : X SLT Standard L ibrary ; 

• www.exslt.org : le site d'EXSLT, une initiative pour proposer et favoriser des exten- 
sions « standardisees ». 

Des sites d'arcliives de discussions concernant X Path ou X SLT : 

• www.biglist.com/lists/xsl-list/archives : I'arcliive de la liste de discussion la plus active 
surXSLT ; 

• http://iists.w3.org/Archives/Public/xsl-editors/: I'archive des discussions publiques sur 
I 'evolution deXSLT ; 

• http://iists.w3.org/Archives/Pubiic/www-xpath-comments/ : I'archive des discussions publi- 
ques sur revolution de X Path ; 

• http://www.dpawson.co.ui</xsi/xsifaq.htmi : la « FoireAux Questions » XSLT, maintenue 
par D, Pawson, 

Des sites de documentation ou d'information surXM L etXSL : 

• www.xmisoftware.com/xsit, et www.xmi.com/ : deux sites qui recensent des produits 
XSLT ouXML ; 

• http://msdn.microsoft.com/xmi : le site M icrosoft dedie a XM L et XSL (et telecharge- 
ment deMSXML). 

• http://www.muiberrytech.com/ : un sitetres actif pourXSL, On y trouvera (entre autres) 
des aide-memoireXM L etXSLT/XPath (en PDF) tres bien faits. 

• http://xmifr.org/ : un site en frangais consacre a X M L et done a XSL (entre autres). 

• http://xmi.coverpages.org/sgmi-xmi.htmi : le site de Robin Cover, une compilation de 
tout ce qui concerne XML et SG M L . 

Des sites de telechargement de produits XSL: 

• http://saxon.sourceforge.net/ : le site de telechargement de Saxon, le processeur XSLT 
de M ichael Kay. 

• http://xmi.apache.org/xaian-j/: le site de telechargement de X alan, I e processeur XSLT 
d'Apache. 

• www.jciari<.com/xmi/xt.htmi : le site de Xt (le processeur XSLT dejames Clark), leplus 
ancien maistoujours le plus rapide. 
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priorites par defaut (algorithme de calcul des -) 
100 

processeur XSLT 
lancement du -83 

principe de fonctionnement d'un -83 
processing- instruction 

dans le modele arborescent X Path (nceud de 
type -) 35 

par I'instruction xslxopy (copie d'une -) 340 
programmation 

en XSLT (les possibilites de -) 167 
les instructions de -167 
patterns de - 395 



programme XSLT (structure d'un -) 75 
proximite pour un axe de localisation 
indices de -53 

R 

recherche de la concordance de motifs (pattern 

matching) 94 
recursion (pattern de programmation) 405 
referencer une variable 184 
references croisees inter fichiers 459 
regie 

de transformation 78 

de visibilite pour les variables globales 212 
de visibilite pour les variables locales 214 
du pape293,335,338 
du pipe 384 

modele nomme (hybride xsLtemplate) 219 
par defaut 119 

pour la racine d'un arbre X M L ou un 
element 120 
pour un noeud de type comment ou 

processing-instruction 120 
pour un noeud de type text ou attribute 120 
priorites 100 

XSLT (forme d'une-) 79 
regroupement 

hierarchique474 

methode de la cle 439, 474 

par la methode de Steve M uench 439, 474 

par preceding-sibling 438 

par valeur 474 

positionnel 474 
reinitialisation d'un numero d'ordre (instruction 

xsLnumber) 360 
rendu de la numerotation (instruction xsLnumber) 
368 

Result Tree Fragment 

en XSLT 1.0 167,208 

en X SLT 1.0 (operations sur un -) 209 
ResultTree Fragment 

Voir aussi RTF 167 
root 

dans le modele arborescent X Path (noeud de 
type -) 31 

par I'instruction xslxopy (copie du noeud -) 
339 

RTF (ResultTree Fragment) 

en node-set (conversion d'un -) 209, 423 
en X SLT 1.0 (operations sur un -) 209 
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S 

saxon:evaluate() 549 

saxon:tokenize() 557 

secondaire (TST, source X M L ~) 192 

select (xshsort, attribut ~) 151 

select="...", variante syntaxique pour xshapply- 

templates 133 
Selection de la valeur d'un attribut dans un cer- 
tain domaine nominal 331 
self (axe de localisation) 49 
Serialisation 

d'unarbreXML 157,159 
d'un node-set 157 
somme des valeurs d'un node- set avec le pattern 

visiteur416 
Source Tree (Temporary ~) 

Voiraussi TST 192 
source XM L secondaire 

exemple d'utilisation d'un TST comme~223 
TST, -192 
string 

action instancier-bourre pour une -402, 404 
decompte de mots dans une - 405 
en morceaux (decoupe d'une -) 419 
fonction index-of(-) 397 

structure 

d'un programme X SLT 75 
dedonneesauxilaire- pattern deprogramma- 
tion (utilisation d'une -) 422 

syntaxe et contrainte pour un motif XSLT 98 

T 

table d'associations 237 
Temporary SourceTree 
calcule 196 

equivalent a un texte 196 
forme degeneree d'un - 196 
forme generale d'un - 194 
obtenu litteralement 193 
operations sur un -198 
texte 196 

text dans le modele arborescent X Path (nceud 

de type -) 36 
texte 

par I'instruction xslxopy 

copied'un -340 
Temporary SourceTree equivalent a un -196 
X M L par un element source I itteral (creation 
de -) 262 

tokenizeO (extension saxon ou xalan -) 557 
traduction par dictionnaire 227 



traitement 

d'un noeud source membre d'une liste de 

noeuds source 88 
d'une liste de noeuds source 88 
des espaces blancs 252 
du document XML source 87 
modele de -87 
transformation 
patterns de -443 
regies de -78 

relativement a un nceud courant et une liste 
courante (instanciation d'un modele de -) 
90 

XML - RTF 579 
transmission d'argument 

instruction xshapply-templates avec -233, 
523 

Tree (Temporary Source -) 

Voiraussi TST 192 
Tree Fragment (Result -) en X SLT 1.0 

Voiraussi RTF 208 
tri (xshsort, attributs specifiant les parametres 

d'un -) 151 
TST (Temporary SourceTree) 192 

calcule 196 

comme source XML secondaire (exemple 
d'utilisation d'un -) 223 

en XSLTl.l ou plus 

exemples d'utilisation d'un - 199 

forme degeneree d'un - 196 

obtenu litteralement 193 

operations sur un -198 

source XML secondaire 192 

texte 196 
Turing (machine de -) 167 
Turing-complet(XSLT -) 167 

U 

URI de base 640 
use- attribute- sets 

pour I'instruction xsl:attribute-set (attribut -) 
307 

pour I'instruction xslxopy (attribut -) 324, 
335 

pour I'instruction xshelement (attribut-) 289, 
305, 307 
utilisation 

d'un TST comme source XML secondaire 

(exemple d'-) 223 
d'un TST en XSLTl.l ou plus (exemples d'-) 

199 



Index 
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d'une structure de donnees auxilaire - pattern 

de programmation 422 
d'une variable 184 
utiliser une variable 
globalel87 
locale 185 

V 

valeur 

d'un attri but dans un certain domaine nominal 

(selection de la ~) 331 
d'une variable (obtention de la ~) 184 
differee d'attribut (attribute value template) 

269 

regroupement par -474 
variable 

conflits de noms de -214 
globalel87 

circularite dans la declaration de -212 
evaluation d'une - 187 
regies de visibilite 212 
globaleet locale 184 
locale 185 

regies de visibilite 214 
obtention de la valeur d'une - 184 
referencer une - 184 
utilisation d'une -184 
xsl:variable 179 
variantes syntaxiques d'expressions renvoyant 

un node-set 70 
visibilite 

pour les variables globales (regies de -) 212 
pour les variables locales (regies de -) 214 
visiteur 

minimum d'un node-set avec le pattern -411 
recursif de node-set (pattern de program- 
mation) 409 
somme des valeurs d'un node-set avec le 
pattern -416 

X 

xalan:evaluate() 549 
xalan:tokenize() 557 
XPath 

expressions -40 

le langage -29 

modele arborescent d'un document X M L vu 
par -30 

xsl (abreviation courante de domaine nominal 

pourXSLT) 75 
xshapply-imports (instruction -) 388 



xsl:apply-templates 

avec transmission d'argument (instruction -) 

233, 523 
instruction -107, 131, 233 
mode-'...", variante syntaxique pour - 134 
select ="...", variante syntaxique pour - 133 
xsl: attribute 

creation d'un domaine nominal par I'instruc- 
tion -329 

creation d'un namespace par I'instruction - 
329 

descripteur de valeur differee pour I 'attri but 
namespace de I'instruction -329 

instruction -289 
xsl: attribute- set 

attri but use-attribute-sets pour I'instruction - 
307 

instruction -304 
xsl:call-template (instruction -) 229 
xsl:choose (instruction ~) 174 
xsl:comment (instruction -) 340 
xshcopy 

attri but use-attribute-sets pour I'instruction - 
324, 335 

copie d'un attribut par I'instruction -335 
copie d'un commentaire par I'instruction - 
340 

copie d'un domaine nominal par 

I'instruction -327, 338 
copie d'un element par I'instruction -326 
copied'un namespace par I'instruction -327, 

338 

copie d'un texte par I'instruction -340 
copie d'une processing-instruction par 

I'instruction -340 
copie du nceud root par I'instruction -339 
equivalence avec xsl :element pour un element 

334 

instruction -321 
xsl:copy-of (instruction -) 156 
xsl:decimal-format 
instruction -612 
xsl:element 

attribut use-attribute-sets pour I'instruction - 

289, 305, 307 
equivalence avec xsl:copy pour un element 
334 

instruction -272 
xsl:fallback (instruction -) 609 
xsl:for-each (instruction -) 137 
xsl:if (instruction -) 169 
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XSLT professionnel 



xshimport 

calcul de la preseance desfeuilles importees 
par -381 

detection de conflits dus a instruction -381 
instanciation de instruction -381 
instruction -381 
interetde instruction -385 
xsl:include 

detection de conflits dus a instruction -375 

instanciation de instruction -375 

instruction -374 

interetde instruction -377 

position des instructions - 376 
xsl:l<ey 

exemple462 

instruction -235 
xsl:message (instruction -) 234 
xsl:namespace-alias (instruction -) 607 
xsl:number 

arbre source X jvi L explore lors de instancia- 
tion de instruction -350, 367 

differents modes de calcul d'un numero 
d'ordre 352 

instruction -344 

numero d'ordre dans un document source 
secondaire 367 

numero d'ordre sans decompte 363 

reinitialisation d'un numero d'ordre 360 

rendu de la numerotation 368 
xshoutput (instruction -) 610 
xshparam 

instruction -216 

parametre -216 
xsl:preserve-space (instruction -) 610 
xshprocessing-instruction (instruction -) 343 



xsl:sort 

attribut case-order 151 
attribut data-type 151 
attribut lang 151 
attribut order 151 
attribut select 151 

attributs specifiant les parametres d'un tri 151 

instruction - 144 
xshstrip-space (instruction -) 172, 471, 473, 610 
xshstylesheet (instruction -) 603 
xshtemplate 

instruction -128, 219 

modele nomme -219 
xshtext 

attribut disable-output-escaping pour instruc- 
tion -260 
instruction -250 
xsl:use-attribute-sets pour un element source 

litteral (attribut-) 312 
xsl:value-of 

disable-output-escaping="...", variante 

syntaxique pour -131 
instruction -102, 128 
xshvariable 179 

instruction -179 
XSLT 

lancement du processeur - 83 
les possibilites de programmation en - 167 
principedefonctionnementd'un processeur - 
83 

Standard Library (XSLTSL) 377, 617 
structure d'un programme - 75 
Turing-complet 167 
XSLTSL (XSLT Standard Library) 377, 617 



